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如 今 的 Android 系统 市 场 份 额 已 节 节 攀升 ， 势 不 可 挡 ， 越 来 越 多 的 开发 者 加 入 到 Android 
应 用 开发 的 行列 。 从 2010 年 的 数据 表明 ，Android 系统 仅仅 推出 两 年 已 超过 诺基亚 的 
Symbian 系统 ， 而 且 2010 年 Android 市 场 应 用 也 相 比 2009 年 增长 了 6 信之 多 ; 最 值得 一 提 的 
是 ， 这 些 与 日 俱 增 的 Android 应 用 程序 中 ， 无 论 是 按 使 用 量 还 是 总 收入 排名 ，70% 的 应 用 排 
行 榜首 都 是 游戏 。 

本 书 以 Java 语言 为 主 系统 讲解 了 Android 游戏 开发 ， 从 最 基础 的 内 容 开 始 ， 让 读者 循序 
渐进 地 学 习 和 掌握 Android 游戏 开发 的 知识 与 技巧 。 对 于 有 Java 基础 的 读者 ， 能 够 更 容易 、 
更 快 地 掌握 ， 当 然 ， 阅 读本 书 不 需要 读者 有 移动 设备 的 开发 经 验 。 

本 书 总 共 8 章 ， 每 章 都 以 前 一 章 的 知识 点 作为 铺垫 展开 ， 所 以 对 于 刚 接触 Android 游戏 
开发 的 读者 ， 建 议 从 前 往 后 依次 逐 章 学 习 。 各 章 知识 点 整体 以 从 易 到 难 、 从 浅 到 深 的 形式 呈 
现 ， 所 以 建议 读者 在 阅读 本 书 时 一 定 不 要 跳 读 ， 否 则 学 习 起 来 可 能 会 事倍功半 。 本 书 各 章 讲 
解 的 内 容 如 下 : 

第 1 章 介绍 Android 平 台 的 趋势 与 发 展 ， 以 及 Android 应 用 开发 环境 的 搭建 。 

第 2 章 通过 一 个 最 简单 的 Android 项 目 代 码 对 Android 开发 的 基础 概念 进行 详细 讲解 。 

第 3 章 介绍 游戏 开发 中 常用 的 一 些 基础 控件 以 及 布局 等 。 

第 4 章 介 绍 Android 游戏 开发 的 方法 ， 讲 解 了 在 Android 平台 进行 游戏 开发 的 一 些 常 用 
框架 、 游 戏 开发 的 基础 概念 以 及 游戏 开发 相关 类 的 说 明 。 

第 5 章 介绍 “飞行 射击 ”游戏 的 开发 ， 本 章 是 对 前 几 章 内 容 的 一 个 综合 演练 ， 尤 其 对 第 
4 章 各 模块 知识 点 的 综合 运用 ， 通 过 本 章 的 学 习 读 者 将 熟悉 和 掌握 游戏 开发 流程 。 

第 6 章 是 游戏 开发 提高 部 分 ， 主 要 介绍 Android 系统 手机 的 一 些 特性 与 独 有 功能 ， 蓝 牙 
对 战 游戏 开发 、 网 络 手机 通信 也 都 将 在 本 章 进 行 讲解 。 

第 7 章 讲解 在 Android 系统 中 结合 Box2D 物理 引擎 进行 游戏 开发 的 方法 。 

第 8 章 讲解 “迷宫 小 球 ” 和 “ 扒 房 子 ” 两 个 Box2d 物理 游戏 的 实战 开发 。 

本 书 中 讲解 的 知识 点 基本 与 Android SDK 版 本 无 关 ， 也 就 是 说 开发 出 的 应 用 在 Android 
操作 系统 的 任意 版 本 下 都 可 以 运行 ， 没 有 版 本 之 间 的 限制 。 当 然 也 有 一 些 内 容 只 有 在 SDK 较 
高 版 本 才 会 有 的 功能 ， 但 是 都 会 在 书 中 有 详细 的 标注 与 提示 ， 比 如 有 关 蓝 牙 功 能 的 开发 需要 
用 到 Android 2.0 版 本 。 

在 本 书 的 撰写 过 程 中 ， 有 幸 得 到 游戏 源 手机 游戏 研发 技术 总 监 桂 志 刚 及 其 教学 团队 的 大 
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力 支 持 。 他 们 从 实际 研发 及 一 线 教 学 实践 出 发 ， 立 足 学 员 需 求 和 未 来 职业 发 展 ， 为 本 书 的 定 
位 、 知 识 体系 及 应 用 实例 的 选择 提供 了 诸多 宝贵 建议 。 本 书 课程 和 教学 体系 在 其 机 构 进行 了 
实践 应 用 ， 取 得 了 较为 理想 的 效果 。 在 此 ， 诚 挚 感谢 游戏 源 游戏 开发 培训 机 构 为 本 书 提供 实 
践 应 用 的 平台 。 

在 此 ， 我 要 特别 感谢 我 的 家 人 ， 完 成 本 书 编写 的 动力 主要 就 是 来 自家 人 对 我 关心 与 支 
持 。 同 时 也 要 感谢 清华 大 学 出 版 社 图 格 事业 部 的 夏 航 彦 老师 对 本 书 的 出 版 做 了 大 量 的 工作 ， 
他 的 Email 是 booksaga@163.com。 

由 于 编者 水 平 有 限 ， 书 中 难免 有 下 漏 之 处 ， 望 广大 读者 指正 批评 ， 意 见 与 建议 请 Email 
至 xiaominghimi@vip.qq.com。 也 可 以 在 编者 的 博客 上 交流 : http://blog.csdn.net/xiaominghimi 
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站 光盘 使 用 说 明 < 


各 光盘 外 括 以 下 Androig 游 戏 项 目 代码 : 


2-1(Activity 生 命 周 期 ) 

3-1(Button 与 点 击 监听 器 ) 

3-10-1( 列 表 之 ArrayAdapter 适 配 ) 
3-10-2( 列 表 之 SimpleAdapter 适 配 ) 
3-11(Dialog 对 话 框 ) 
3-12-5(Activity 跳 转 与 操作 ) 
3-12-6( 横 坚 屏 切换 处 理 ) 
3-3(ImageButton 图 片 按钮 ) 
3-4(EditText 文 本 编辑 
3-5(Check I 听 ) 
3-6(RadioButton 与 监听 ) 
3-7(ProgressBar 进 度 条 ) 

3-8(SeekBar 拖 动 条 ) 

3-9(Tab 分 页 式 菜单 ) 

4-10( 可 视 区 域 ) 
4-11-1(Animation 动 画 ) 

4-11-2-1( 动 态 位 图 ) 

4-11-2-2( 帧 动画 ) 

4-11-2-3( 剪 切 图 动画 ) 

4-13( 操 作 游戏 主角 ) 

4-14-1( 和 矩形 碰撞 ) 

4-14-2( 圆 形 碰撞 ) 

4-14-4( 多 矩形 碰 接 ) 
4-14-5(Region 碰 撞 检测 ) 

4-15-1 (MediaPlayer 音 乐 ) 
4-15-2(SoundPool 音 效 ) 

4-16-1( 游 戏 保存 之 SharedPreference) 
4-16-2( 游 戏 保存 之 Stream) 
4-3(View 游 戏 框架 ) 
4-4(SurfaceView 游 戏 框架 ) 
4-7-1( 贝 塞 尔 曲线 ) 

4-7-2(Canvas 画 布 ) 

4-8(Paint 画 笔 ) 


4-9(Bitmap 位 图 泻 染 与 操作 ) 
5-1( 飞 行 射击 游戏 实战 ) 
6-1(360” 平 滑 游戏 摇 杆 ) 
6-10-1(Socket 协 议 ) 
6-10-2(Http 协 议 ) 

6-11( 本 地 化 与 国际 化 ) 

6-2( 多 触 点 缩放 位 图 ) 
6-3( 触 屏 手 势 识 别 ) 
6-4( 加 速度 传感器 ) 
6-5(9patch 工 具 ) 

6-6( 截 屏 ) 

6-8( 游 戏 视图 与 系统 组 件 ) 
6-9( 蓝 牙 对 战 游戏 ) 
7-10-1( 人 遍历 Body) 
7-10-2(Body 的 m_userData) 
7-11( 为 Body 施 加 力 ) 
7-12(Body 碰 撞 监 听 ) 
7-13-1( 距 离 关节 ) 
7-13-2( 旋 转 关节 ) 
7-13-3( 齿 轮 关节 ) 
7-13-4( 滑 轮 关 节 ) 
7-13-5-1( 通 过 移动 关节 移动 Body) 
7-13-5-2( 通 过 移动 关节 绑 定 两 个 Body 动 作 ) 
7-13-6( 鼠 标 关节 - 拖 搜 Body) 
7-14(AABB 获 取 Body) 
7-16-1( 迷 宫 小 球 ) 
7-4(Box2d 物 理 世 界 ) 
7-5( 在 物理 世界 中 添加 和 矩形 ) 
7-7( 添 加 自 定义 多 边 形 ) 


7-9( 在 物理 世界 中 添加 圆 形 ) Se 


8-1( 迷 宫 小 球 ) 2 
8-2( 堆 房子 ) 局 
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Android 平台 介绍 与 环境 搭建 


从 本 章节 可 以 学 习 到 : 


学 Android 平台 简介 
党 Android 开发 环境 的 搭建 
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1 1 Android 平台 简介 


Android 一 词 的 本 义 指 “ 机 器 人 ”， 也 是 Google 公司 用 来 作为 2007 年 11 月 5 日 宣布 的 
基于 Linux 平台 的 开源 手机 操作 系统 的 名 称 ， 该 平台 由 操作 系统 、 中 间 件 、 用 户 界 面 和 应 用 
软件 组 成 ， 是 首 个 为 移动 终端 打造 的 真正 开放 和 完整 的 操作 系统 。Google 公司 分 别 在 2009 
年 4 月 28 日 发 布 了 Android 1.5 SDK，2009 年 9 月 16 日 发 布 了 Android 1.6 SDK，2010 年 1 
月 5 日 发 布 了 Android 2.1。 目 前 最 新 版 本 是 2010 年 12 月 6 日 发 布 的 Android 2.3 Gingerbread 
和 2011 年 2 月 3 日 发 布 的 、 专 用 于 平板 电脑 的 Android 3.0 Honeycomb 操作 系统 。 


1.1.1 Android 操作 系统 平台 的 优势 和 趋势 
说 到 Android 操作 系统 平台 的 优势 ， 不 得 不 提 到 最 突出 的 两 个 特点 “免费 ”和 “开源 ”。 


@ 免费 : Android 免费 提供 其 操作 系统 ， 让 移动 电话 制造 商 可 以 免费 搭载 Android 操作 
系统 ， 使 得 手机 的 制造 成 本 大 大 降低 ， 渐 渐 使 得 Android 普及 。 

@ 开源 : Android 手机 操作 系统 源 代码 的 开放 性 ， 不 仅 让 开发 者 可 以 在 统一 开放 平台 进 
行程 序 开发 ， 而 且 可 以 解决 现今 市 场 不 同 智 能 机 之 间 因 文件 格式 不 同 造成 信息 交流 不 
便 、 程 序 内 容 无 法 移植 等 问题 ; 并且 Android 的 开源 就 意味 着 手机 使 用 者 不 必 再 被 动 
地 接受 移动 电话 制造 商 默认 的 设置 和 环境 ， 使 用 者 完全 可 以 根据 自己 的 需求 和 想法 自 
定义 手机 的 配置 。 


2010 年 数据 表明 ，Android 系统 推出 2 年 时 间 已 经 超越 了 诺基亚 Nokia) 的 Symbian 系 
统 ， 而 且 Android 市 场 应 用 数量 也 相 比 去 年 增加 了 6 倍 之 多 。 这 里 值得 一 提 的 是 ， 这 些 与 日 
俱 增 的 Android 应 用 程序 中 ， 无 论 是 按 使 用 量 还 是 总 收入 来 排名 ，70% 的 应 用 排行 榜首 都 是 
游戏 。 

如 今 Android 的 发 展 趋势 势不可挡 ，Android 已 经 成 为 移动 设备 开发 行业 中 不 得 不 学 的 平 
台 之 一 。 有 关 Android 平台 的 介绍 ， 这 里 只 是 简单 地 进行 概述 ， 如 果 大 家 想 详细 了 解 的 话 ， 
可 以 参考 其 他 书籍 或 者 在 网 上 自行 查阅 相关 知识 。 


1.1.2 ” Android SDK 与 Android NDK 


Android SDK (Software Development Kit) 是 Android 软件 开发 工具 包 ， 用 于 辅助 
Android 操作 系统 软件 开发 ， 是 开发 Android 软件 、 文 档 、 范 例 、 工 具 的 一 个 集合 。 

Android NDK (Native Development Kit) 类 似 于 Android SDK ，Android 操作 系统 刚 发 布 
的 时 候 ， 限 定 所 有 的 应 用 程序 开发 都 使 用 Java 语言 进行 编写 ， 后 来 为 方便 C/C++ 开发 者 更 快 
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地 进入 Android 开发 行列 以 及 让 开发 者 更 直接 地 接触 Android 系统 资源 ， 就 推出 了 NDK， 使 
得 利用 传统 的 C/C++ 语言 也 可 以 编写 Android 程序 。 

本 书 使 用 Java 语言 和 Android SDK 进行 讲解 。 

Android 开发 人 员 的 网 站 网 址 为 : developer.android.com， 上 面 可 以 查阅 到 Android 
SDK、 开 发 指南 、API 说 明 等 信息 。 读 者 在 以 后 的 开发 中 可 以 不 断 地 查阅 这 些 相 关内 容 。 


| .2 Android 开发 环境 的 搭建 


本 节 只 向 大 家 介绍 在 Windows 下 配置 Android 开发 环境 ， 有 关 Linux、Mac OS 等 系统 下 
配置 Android 开发 环境 的 方法 请 自行 查阅 相关 书籍 。 


1.2.1 ”搭配 环境 前 的 准备 工作 
Android 开发 环境 搭建 前 ， 需 要 下 载 Java JDK、Eclipse 、Android SDK 以 及 ADT。 
@ JDK: 是 整个 Java 的 核心 ， 包括 了 Java 的 运行 环境 (Java Runtime Envirnment ) 、 类 
库 以 及 Java 开发 工具 等 等 。 
@ Eclipse: 简单 而 言 就 是 一 个 IDE 集成 开发 环境 。 
。 Android SDK: Android 开发 工具 包 ， 内 含 Android 虚拟 设备 ， 即 Android 模拟 器 。 


@ ADT: 是 Google 研发 的 一 个 插件 ， 此 插件 集成 在 Eclipse 中 ， 可 为 开发 Android 提供 
专属 开发 环境 并且 ADT 中 包括 创建 实例 、 运 行 和 除 错 等 功能 。 


1. Java JDK 下 载 


Java JDK 的 下 载 地 址 为 : http://www.oracle.com/technetwork/java/javase/downloads/index.html。 
因为 Sun 公司 被 Oracle 公司 收购 了 ， 所 以 JDK 需要 从 Oracle 公司 网 站 下 载 。 在 如 图 1-1 
所 示 的 页 面 上 单 击 “Java” 图 标 ， 进 入 下 一 页 面 ， 如 图 1-2 所 示 。 
在 如 图 1-2 所 示 的 界面 中 : 
全 3 吏 ” 根 据 提 示 选 择 当 前 使 用 的 电脑 操作 系统 ; 
丰 到 和 2》 选中 同意 许可 协议 检查 框 ; 
介 王 吏 单 击 “Continue” ( 继续 ) 按钮 进入 下 一 页 面 ， 如 图 1-3 所 示 。 
在 图 1-3 所 示 的 下 载 界面 中 ， 单 击 “jdk-6u24-windows-i586.exe ”链接 进行 下 载 。 


2. Android SDK 的 下 载 


Android SDK 的 下 载 地 址 :http://dl.google.com/android/archives/android-sdk-windows- 
1.6_r1.zip。 按 此 链接 下 载 下 来 的 SDK 包含 1.5 和 1.6 版 本 。 
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3. Eclipse IDE 的 下 载 


Eclipse IDE 的 下 载 地 址 为 http://www.eclipse.org/downloads/。 从 浏览 器 中 输入 下 载 地 址 ， 
打开 如 图 1-4 所 示 的 页 面 ， 选 中 “Eclipse Classic 3.6.1” 经 典 版 本 进行 下 载 。 
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这 里 需要 说 明 的 是 : 使 用 Android 开发 应 用 程序 时 ， 不 仅 需 要 Eclipse 主 程 序 还 需要 
Eclipse JDT (Java Development Tools) 和 WTP (Web Tools Platform) 这 两 个 开发 工具 插件 。 
由 于 Eclipse Classic 3.4 以 上 的 版 本 已 经 包含 了 这 两 个 插件 ， 所 以 在 配置 Android 开发 环境 的 
时 候 ， 只 要 选取 Eclipse Classic 3.4 以 上 的 版 本 ， 这 样 就 不 用 额外 地 安装 JDT 和 WTP 这 两 个 


插件 了 。 单 击 下 载 Eclipse 时 ， 根 据 电 脑 的 操作 系统 来 选择 其 是 32 位 还 是 64 位 的 版 本 。 


1.2.2 


安装 和 配置 环境 


Eclipse 运行 环境 的 前 提 是 电脑 已 经 安装 JDK 才 可 以 打开 ， 所 以 解压 Eclipse 之 前 需要 先 
安装 JDK， 在 开发 工具 的 安装 过 程 中 ， 其 安装 路 径 最 好 是 英文 ， 尽 可 能 避免 中 文 路 径 ， 以 免 
出 现 不 可 预知 的 BUG。 环境 具 体 安装 和 配置 的 步骤 如 下 ; 
于》 安装 JDK， 安 装 的 路 径 随意 。 

仍 避 了 3》 然后 解压 Eclipse， 解 压 路 径 随意 。 
已 油 现在 Eclipse 解压 目录 下 找到 “eclipse.exe” 文 件 ， 然 后 单 击 启动 Eclipse， 可 以 使 用 


右键 在 


这 里 单 和 


引 


己 Workspace 


Select a workspace 


Eclipse SDK stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session. 


回 : this as the default and do not ask again 


图 1-5 Eclipse 预 配置 


的 快捷 键 或 者 操作 大 家 可 以 阅读 相关 资料 ， 本 书 中 会 适当 讲解 一 些 ) 。 


电脑 桌面 上 发 送 一 个 快捷 方式 以 方便 启动 。 启 动 Eclipse 的 过 程 中 会 弹出 窗 
口 ， 如 图 1-5 所 示 。 


上 “Browse” 按 钮 选择 Eclipse 的 工作 路 径 ， 如 果 下 次 启动 Eclipse 不 想 再 显 
比 窗口 ， 可 以 选中 此 界面 的 左下 角 ， 表 示 下 次 默认 使 用 此 路 径 ( 关于 Eclipse 


常 


接 下 来 开始 安装 ADT。 进 入 Eclipse 主 界面 ， 然 后 打开 “Help” 菜 单 ， 选 中 “Install 
New Software” 选 项 ， 如 图 1-6 所 示 。 
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柜 Java-Ecipsesi 
Fle Edit Source Refactor Navigate Search Project Run Window [Help 
LA LAd 


About Eclipse SDK 


图 1-6 Eclipse 选择 安装 插件 


ADT 的 安装 方式 有 两 种 ， 在 线 下 载 安装 和 离线 安装 ， 分 别 说 明 如 下 。 


(1) 在 线 下 载 安装 
进入 安装 插件 的 界面 ， 单 击 “Add ”按钮 ， 在 “Location ”文本 框 中 填 入 以 下 网 址 : 


http://dl-ssl.google.com /android/eclipse/， 如 图 1-7 所 示 。 


Available Software 
Select a site or enter the location of a site, 


Work with: bpe or select a site ~ [add- 
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然后 将 “Developer Tools” 全 部 选中 ， 单 击 “Next” 按 钮 ，ADT 安装 完成 之 后 ，Eclipse 
会 提示 重启 Eclipse， 同 意 使 之 重启 即 可 完成 ADT 的 安装 。 

(2) 离线 安装 

先 自行 下 载 Android ADT 的 离线 安装 包 ， 这 里 给 出 Android ADT 0.9.7 版 本 的 下 载 地 址 ; 
http://dl.google.com/android/ADT-0.9.7.zip， 然 后 在 图 1-7 所 示 的 选择 插件 路 径 界 面 中 ， 单 击 
“Archive ”按钮 ， 找 到 下 载 好 的 ADT 插件 路 径 。 后 续 操 作 如 同 在 线 安装 的 步骤 一 样 。 如 果 
处 于 断 网 的 状态 ， 在 单 击 “Next” 按 钮 之 前 ， 建 议 大 家 将 左下 角 的 “Contact all updata...” 这 
一 选项 的 选中 取消 ， 无 需 检 查 更 新 ， 从 而 加 快 安装 速度 。 

这 里 要 注意 一 点 ， 当 离线 安装 的 时 候 ， 使 用 “Eclipse Classic ”的 版 本 很 难 正常 离线 安 
装 ， 这 是 因为 仍然 缺少 必要 的 插件 ， 解 决 方法 是 Eclipse 使 用 “Eclipse IDE for java EE” 版 本 
即 可 。 


介 天 到 配置 Android SDK。 


(1) 解压 下 载 好 的 Android SDK ， 然 后 单 击 Eclipse 主 菜单 “Window ”下 的 
“Perferences” 选 项 ， 进 入 配置 ， 如 图 1-8 所 示 。 
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1-8 Eclipse 配置 选择 


(2) 如 果 ADT 正确 安装 了 ， 那 么 在 “Preferences ”界面 的 左 侧 会 出 现 “Android” 一 
栏 ， 单 击 “Android” 选 项 ， 此 时 右 侧 单 击 “Browse...” 按 钮 ， 选 择 Android SDK 解压 后 的 路 
径 ， 如 图 1-9 所 示 。 
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Editors 
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Plug-in Development 
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‘type filter text 


@ Value must be an existing directory 


Android Preferences 
SDK Location: 
Note: The list of SDK Targets below is only reloaded once you hit 'Apply or ‘OK'. 


Target Name Vendor Platform 。 API … 


No target available 


路 径 选 择 正 确 之 后 ， 在 下 方 会 显示 当前 SDK 中 包含 的 版 本 ， 然 后 单 击 “OK ”按钮 ， 完 
1-10 所 示 。 


成 SDK 配 置 ， 如 
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Android 


Android Preferences 


SDK Location: F\Andriod\softbag\android-sdk-windows-1.6.r1\a 


Note: The list of SDK Targets below is only reloaded once you hit 'Apply or ‘OK 


Target Name Vendor Platform APL ». 
Android 1.5 Android Open Source Proj 15 
Google Apls Google Inc. 15 
Android 1.6 Android Open Source Project 16 
Google Apls Google Inc. 16 
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创建 AVD ( Android 模拟 器 ) 

AVD 是 Android Virtual Device 的 缩写 ， 指 Android 运行 的 虚拟 设备 。 创 建 AVD 有 两 种 方 
式 ， 第 一 种 通过 Eclipse IDE 来 进行 创建 ， 另 一 种 则 使 用 命令 行进 行 创建 。 下 面 来 介绍 利用 
Eclipse 开发 环境 创建 AVD 的 步骤 : 

当 SDK 路 径 配 置 正确 之 后 ， 在 Eclipse 的 主 界面 的 左上 角 可 以 看 到 一 个 机 器 人 的 标志 ， 
如 图 1-11 所 示 ， 单 击 进 入 SDK&AVD 管理 界面 ， 如 图 1-12 所 示 。 


File Edit Run Source Refactor Navigate 


图 1-11 选择 AVD 标 志 


Android SDK and AVD Manager Isl 
Uist of existing Android Virtual Devices located at CAUsers\Himi\android\avd 
9 jr mn pe ] 
| Available packages || New.. 
YAndroid_ Emal。 Android 1.6 16 4 
Edit.. 
| Delete... 
Repair 
Details... 
Refresh 
Y Avalid Android Virtual Device. FY A repairable Android Virtual Device. 
X An Android Virtual Device that failed to load. Click 'Details' to see the error. 


1-12 SDK&AVD 管理 界面 


在 SDK&AVD 管理 界面 中 可 以 进行 添加 、 删 除 、 编 辑 AVD 以 及 对 SDK 版 本 更 新 等 操 
作 。 这 里 先 讲解 如 何 添加 一 个 新 的 AVD。 

单 击 管理 界面 中 的 “New” 选 项 ， 然 后 在 弹出 的 “Create new Android Virtual Device” 界 
面 中 ， 如 图 1-13 所 示 ， 来 手动 设置 Android 模拟 器 的 属性 ， 例 如 : 模拟 器 的 名 称 、 分 辨 率 、 
SDK 版 本 、 是 否 创建 SDcard 等 等 。 这 里 先 来 创建 一 个 简单 AVD， 在 图 1-13 所 示 的 界面 中 ， 
只 是 给 模拟 器 起 个 名 字 以 及 选择 一 个 SDK 版 本 ， 最 后 单 击 下 方 的 “Create AVD” 按 钮 即 可 完 
成 AVD 的 创建 。 
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Override the existing AVD with the same name 


7 
图 1-13 填写 虚拟 设备 属性 界面 


1.2.3 ”SDK 版 本 更 新 


1. 更 新 ADT 插件 
首先 更 新 Eclipse 的 ADT 插件 ， 具 体 步 又 如 下 : 
到 三 了 》 单 击 Eclipse 工具 栏 ， 打开“Help” 菜 单 ， 然 后 选中 “Check for Updates” 选 项 ， 如 


1-14 所 示 。 


[Help | 
Welcome 


回 Help Contents 
WD Search 
Dynamic Help 
Key Assist... Ctrl+Shift+L 
Tips and Tricks.. 
站 Report Bug or Enhancement... 
Cheat Sheets... 


About Eclipse 


1-14 ”插件 更 新 选项 


Android 游 戏 编程 之 从 零 开 始 


要 于》 然后 Eclipse 会 联网 检查 可 更 新 的 插件 ， 如 果 有 可 更 新 的 插件 会 进入 “Available 
Updates” 界 面 ， 如 图 1-15 所 示 。 


Available Updates 
Check the updates that you wish to install. 


Name Version 1d 

家 Android DDMS 10.0.0... comandroidjdeeclipseddmsfea 
钱 Android Development Tools 10.0.0... comandroidideeclipseadtfeatur 
家 Android Hierarchy Viewer 10.0.0... comandroidjdeeclipsehierarchy 


图 1-15 可 更 新 插件 选择 界面 


在 图 1-15 所 示 的 界面 中 ， 可 以 看 到 当前 最 新 ADT 版 本 ( version ) 是 10.0.0 ， 选 中 
需要 更 新 的 插件 之 后 ， 单 击 “Next” 按 钮 ， 最 后 单 击 “Finish” 按 钮 即 可 。 


2. 更 新 Android SDK 

当 ADT 更 新 完毕 之 后 ， 就 可 以 进行 Android SDK 的 更 新 ， 具 体 步 又 如 下 : 

在 Eclipse 工具 栏 中 选中 “绿色 机 器 人 ”图 标 进 入 SDK&AVD 管理 界面 ， 单 击 左 侧 
“Available packages” 选 项 ， 然 后 选中 右 侧 的 “Android Repository ”选项 ， 选 中 后 会 自动 联 
网 检查 可 更 新 的 SDK 版 本 ， 之 后 选中 需要 升级 的 版 本 〈 如 图 1-16 所 示 ) ， 接 下 来 单 击 
“Install Selectd” 按 钮 ，SDK 将 自动 下 载 安 装 。 下 载 安装 完毕 后 ， 重 启 Eclipse 即 可 完成 
SDK 的 升级 。 
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Duavailable P 


Android SDK Tools, revision 10 
Android SDK Platform-tools, revision 3 
ocumentation for Android SDK ApI 11, revision 1 
DK platform Android 3.0, API 11, revision 1 
DK Platform Android 2.3.3, API 10, revision 1 
DK Platform Android 2.2, API 8, revision 2 
DK Platform Android 2.1, API7, revision 2 
DK Platform Android 1.6, API 4, revision 3 
by SDK platform Android 1.5, API 3, revision 4 
Samples for SDK API 11, revision 1 
> Samples for SDK ApI 10, revision 1 
， 国 @@ Samples for SDK API 9, revision 1 
) 辆 OO Samples for SDK API 8, revision 1 
Samples for SDK API7, revision 1 


ee 
a 


roid Repository 
a es ) 
| 


图 1-16 SDK 可 更 新 版 本 选择 界面 


] . 妇 本 章 小 节 
本 章 简单 介绍 Android 操作 系统 平台 ， 并 把 重点 放 在 Android 开发 环境 的 搭建 上 面 。 读 


者 通过 本 章 的 学 习 ， 掌 握 Android 开发 环境 的 搭建 和 SDK 版 本 更 新 的 方法 ， 为 开始 学 习 游 戏 
应 用 开发 打下 工具 基础 。 
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Hello，Androidl 


从 本 章节 可 以 学 习 到 : 


学 创建 第 一 个 Android 项 目 

学 剖析 Android Project 结构 

学 AndroidManifest.xml 与 应 用 程序 功能 组 件 
学 运行 Android 项 目 〈 启 动 Android 模拟 器 ) 
学 详解 第 一 个 Android 项 目 源码 

学 Activity 生命 周期 

党 Android 开发 常见 问题 


第 2 章 ”Hello, Android! 


2 .| 创建 第 一 个 Android 项 目 


启动 Eclipse， 依 次 单 击 “File 一 New 一 Project” 菜 单项 ， 弹 出 以 下 界面 (如 图 2-1 所 
示 ) ， 选 中 “Android ”目录 下 的 “Android Project” 选 项 ， 单 击 “Next” 按 钮 开始 创建 
Android 项 目 。 


Select a wizard 


Wizards: 
[ype fikter text 


财 Java Project 
尘 Java Project from Existing Ant Buildfile 
区 Plug-in Project 

b GE General 


b EE CVS 
b EB Java 
b GC Plug-in Development 


2-1 创建 Android 项 目 


然后 弹出 创建 Android 项 目 配 置 界面 ， 如 图 2-2 所 示 。 在 界面 上 的 “Project Name” 文 本 
框 填 写 “MyFirstProject”， 在 “Build Target” 选 项 组 中 选中 “Android 1.6” 复 选 框 ， 最 后 单 
击 “Finish” 按 钮 完成 项 目 创建 。 
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New Android Project 


Creates a new Android project resource. 


pairam 

Contents 项 目 名 称 
© Create new project in workspace 

© Create project from existing source 

园 Use defauk location 


Di/Book_workspace/Myfirstproject 
) Create project from existing sample 


Samples: ApiDemos 


Android Open Source Project 
Google Inc. 
国 Android 1.6 Android Open Source Project 
加 Google Apls Google Inc. 
@| Android 20 Android Open Source Project 
回 Google Apls Google Inc. 
加 Android 201 Android Open Source Project 
回 Google Apls Google Inc. 
加 Android 21 Android Open Source Project 
回 Google Apts Google Inc. 
加 Android 22 Android Open Source Project 
加 Google Apts Google Inc. 


Standard Android platform 1.6 
Properties 

Application name: MyFirstproject 应 用 名 称 ( 安装 手机 上 显示 的 名 字 ) 
Package name: com.himi 包 各 

园 create Activity: = MainActivity 主 Activity 类 各 

Min SDK Version: 4 《可 省 咯 不 填 ) 最 低 运行 版 本 号 ，“4” 对 应 SDK1.6 


[EEC 


图 2-2 ”新建 项 目 配置 


2 .2 齐 析 Android Proiedt 结构 


在 完成 “MyFirstProject” 项 目 创建 之 后 ， 可 以 在 “Pckage Explorer” 视 图 中 看 到 整个 项 
目的 结构 ， 如 图 2-3 所 示 。 我 们 将 在 本 节 对 Android Project 的 结构 进行 剖析 。 
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六 国 MainActivityjava 
4 BB gen [Generated Java Files] 
4 出 comhimi 
国 Rjava 
b a Android 1.6 


4 BE drawable-hdpi 


套 icon.png 
4 BS drawable-ldpi 


国 iconpng 


4 BE drawable-mdpi 
天 icon.png 
4 BG layout 
因 mainxml 
4 EB values 
因 stringsxml 
回 AndroidManifestxml 
defaultproperties 


图 2-3 项 目 结构 


(1) src 目录 用 来 存放 项 目 源 代 码 (java) 。 

(2) gen 目录 下 存放 Rjava 文件 ，R.java 文件 是 该 项 目 所 有 资源 的 索引 文件 ， 在 建立 项 目 
时 自动 生成 的 ，R.java 文件 属于 只 读 模 式 ， 不 能 更 改 ， 一 般 不 会 对 其 进行 修改 。R 类 中 包含 
很 多 静态 类 ， 其 中 这 些 静 态 类 的 名 称 都 与 res 目录 下 的 资源 目录 一 一 对 应 ， 如 图 2-4 所 示 。 


package com.himi; 
1 ES res 
public final class R { 4 GB drawable-hdpi 
public static final class attr { 柄 icon.png 
} 4 CE drawable-ldpi 
public static final class drawable 醒 icon 
public static final int icon=0x7f02055s Weng 
} EB drawable-mdpi 


public static final olass layout se 三 icon.png 
public static final int main=0xTf0300007 4 GE layout 

} 网 mainxml 

public static final class string A 


PO 
public static final int app_name=0x7£040001; 


public static final int hello=0x7£040000; Bwingssnl 


2-4 RR 文件 与 资源 文件 的 对 应 关系 


村 
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假如 在 项 目 中 新 加 一 张 图 片 放 在 drawable 目录 下 ， 刷 新 项 目 ， 那 么 R 资源 文件 就 会 更 
新 ， 为 其 新 添加 的 图 片 生 成 一 个 新 的 索引 。 
R 文件 的 作用 和 优点 : 


日 因为 及 文件 会 将 所 有 资源 生成 索引 ， 所 以 在 项 目 中 使 用 资源 的 时 候 会 很 便捷 。 
@ 编译 器 在 对 项 目 进行 编译 的 时 候 会 检查 R 文 件 中 的 资源 是 否 被 使 用 ， 没 有 被 使 用 的 资 
源 ， 编 辑 器 不 会 编译 到 应 用 中 ， 从 而 节省 在 手机 中 占用 的 内 存 。 


(3) Android (Library) 目录 : 此 目录 下 的 “android.jar” 文 件 指向 的 是 Android SDK， 

是 开发 Android 应 用 程序 所 用 到 的 所 有 API 函数 库 。 

assets 目录 是 用 来 存放 引用 的 外 部 资源 ， 此 目录 与 res 目录 最 大 的 区 别 在 于 res 路 径 下 的 
资源 文件 都 会 在 R 资源 文件 中 自动 生成 对 应 资源 ID， 而 assets 目录 下 资源 则 不 会 。 

(4) res 目录 是 用 来 存放 项 目 中 用 到 的 资源 文件 ， 有 5 个 默认 子 目录 。 

其 子 目录 drawable-hdpi、drawable-ldpi、drawable-mdpi 是 用 来 存放 图 片 资源 的 ， 如 图 
片 、 图 标 (*.jpg、*.png 等 ) 。 

如 果 创 建 Android 项 目的 时 候选 择 的 版 本 是 SDK 1.5 或 者 更 低 的 版 本 ， 那 么 res 目录 下 默 
认 只 有 3 个 子 目录 ， 如 图 2-5 所 示 。 


2 区 drawable-hdpi 
辆 | icon.png 
4 EE drawable-ldpi 


2 EE drawable 辐 | icon.png | 
而 | i 4 GE drawable-mdpi 
古 icon.png 


页 icon.png 
4 GG layout 
四 main.xml 


4 EC Tayout 

四 main.xml 
4 GC values 

四 strings.xml 


4 世 values 
四 strings.xml 


SDK 1.5 之 前 ( 包含 1.5 ) res 目 录 结 构 SDK 1.5 以 后 ( 包含 1.5 ) res 目 录 结 构 


图 2-5 SDK 不 同 版 本 下 res 默认 目录 对 比 


大 家 还 记得 在 创建 虚拟 设备 的 时 候 会 设置 一 些 模拟 器 的 属性 和 参数 ， 那 么 Android 会 根 
据 创 建 的 模拟 器 的 分 辩 率 参数 分 别 选 用 对 应 目录 下 的 图 片 资源 ， 如 果 不 小 心 放 错 了 位 置 ， 那 
么 也 没关系 ， 当 Android OS 在 对 应 drawable 目录 下 找 不 到 资源 时 ， 会 从 其 他 两 个 子 目录 下 进 
行 寻找 。 

从 Android SDK 1.5 版 本 之 后 ，res 目录 中 之 前 默认 的 drawable 目录 变 成 了 三 个 类 似 的 目 
录 ， 这 是 Google 为 了 方便 开发 者 在 开发 应 用 时 兼容 不 同 机 型 屏幕 所 设计 的 一 种 让 应 用 支持 多 
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分 辨 率 的 形式 ， 建 议 各 文件 夹 根 据 需 求 均 存放 不 同 版 本 的 图 片 ， 以 下 是 其 对 应 关系 : 


e@ drawable-hdpi: 存放 高 分 辨 率 的 图 片 ， 例 如 WVGA (480x800) ，FWVGA (480x 
854); 

。 drawable-mdpi: 存放 中 等 分 辩 率 的 图 片 ， 例 如 HVGA (320 x 480); 

e@ drawable-ldpi: 存放 低 分 辨 率 的 图 片 ， 例 如 QVGA (240x320) 。 


子 目 录 layout 用 来 存放 布局 文件 以 及 xml 格 式 的 描述 文件 。 

子 目 录 value 放置 项 目 需要 显示 的 各 种 文字 ， 也 可 以 存放 多 个 *xml 文件 ， 存 放 不 同类 型 
的 数据 ， 比 如 colors.xml (字体 颜色 ) 、styles.xml (显示 类 型 ) 等 等 。 

这 里 的 value 要 延伸 一 下 : 假如 应 用 需要 发 布 到 国外 、 中 国 台湾 等 地 区 ， 那 么 因为 语言 
的 差异 ， 文 字 表达 上 肯定 也 要 对 其 进行 修改 ， 如 果 应 用 做 了 本 地 化 操作 ， 就 不 用 烦心 这 种 事 
情 。 本 地 语言 ， 简 单 的 说 ， 就 是 Android 手机 系统 会 根据 手机 系统 语言 默认 使 用 程序 中 对 应 
的 目录 资源 文件 的 原理 ， 如 同上 面 的 drawable 目录 一 样 ， 将 不 同 的 语言 资源 放置 其 目录 下 ， 
例如 把 value 文件 夹 扩展 成 以 下 形式 ， 如 图 2-6 所 示 。 


4 i values-en-rUS 

[Wstrings.xml 1.13 
4 Br values-zh-rCN 

哆 stringsxml 1.17 
4 values-zh-rTW 

网 stringsxml 1.18 


图 2-6 本 地 化 的 value 目录 


当 Android 手机 系统 语言 调整 成 英文 的 时 候 ， 会 使 用 “value-en-rUS” 目 录 ， 当 是 繁体 语 
言 的 时 候 ， 会 使 用 “value-zh-rTW ”目录 。 这 样 一 来 ， 不 同 国家 即使 使 用 不 同 语言 的 手机 系 
统 ， 应 用 程序 也 照样 适应 。 关 于 本 地 化 后 续 文 章 会 有 更 加 详细 的 说 明 ， 这 里 就 不 多 说 了 。 

值得 一 提 的 是 在 Android 系统 中 ， 图 片 、 声 音 等 资源 名 称 不 能 使 用 大 写 英文 字母 ! 


在 讲解 res 目录 的 时 候 ， 一 直 在 说 明 默 认 目 录 ， 其 实在 res 中 还 有 很 多 放置 资源 的 目 
， 比 如 raw (声音 ) 等 ， 也 可 以 自 定 义 子 目录 。 


(5) AndroidManifestxml 是 当前 项 目的 配置 文件 ， 其 中 包含 编码 格式 、 应 用 的 icon、 程 
序 的 版 本 号 以 及 指定 该 程序 使 用 到 的 服务 等 等 。 这 里 需要 注意 ， 如 果 新 添加 一 个 Activity， 
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就 需要 在 这 个 文件 中 进行 相应 配置 ， 然 后 才能 调用 此 Activity， 设 定 Activity 的 属性 也 在 此 设 
定 。 

(6) default.properties 是 记录 项 目 工程 的 环境 信息 。 

大 家 可 能 会 对 Android 这 种 目录 结构 很 疑惑 ， 为 什么 要 使 用 xml 来 进行 开发 ， 这 里 简单 
地 说 明 一 下 。 比 如 把 项 目 中 用 到 的 系统 组 件 都 定义 到 layout 布局 文件 中 ， 而 项 目 中 所 有 用 到 
的 字符 串 都 定义 到 string.xml 中 。 一 旦 需要 更 新 应 用 ， 那 么 无 需 再 去 java 源码 中 修改 和 更 新 
数据 ， 而 是 直接 对 其 layout 和 string.xml 进行 修改 和 更 新 就 可 以 了 ; 也 就 是 说 利用 xml 来 进 
行 开发 可 以 更 好 的 维护 项 目 以 及 方便 修改 和 更 新 程序 。 


pm 3 AndroidManifest.xm | 与 应 用 程序 功能 组 件 


在 每 个 Android 应 用 程序 中 都 必须 具备 AndroidManifest.xml 这 个 文件 ， 此 文件 定义 了 该 
程序 的 主要 功能 、 处 理 的 信息 ， 以 及 执行 的 动作 等 等 。 这 里 对 其 进行 详细 说 明 ， 并 通过 
AndroidMainfest 对 Android 应 用 程序 组 件 进 行 详细 地 介绍 。 

打开 “MyFirstProject” 项 目下 的 AndroidMainfest.xml 文件 : 


<?xml version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package= "com. himi" 
android:versionCode="1" 
android:versionName="1.0"> 
<application android:icon="@drawable/icon" 
android:label="@string/app_name"> 
<activity android:name=".MainActivity" 
android:label="@string/app name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


2.3.1 AndroidManifest 的 xml 语法 层次 


AndroidManifest 的 xml 语法 层次 如 图 2-7 所 示 。 
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Kaanifest>| ?RE | 
| alicuio> | = 
| uses-permissioo)lacuvitz 起  | 
| erissiom> | ceceiver>|cintenttite BE 
| kinstzmentatiop)|service> |oetaaata> cactiom> | 
| uses-sap Joroviao| eatceory, | 


| | [Lo 


图 2-7 AndroidManifest 的 xml 语 法 层次 


在 上 面 的 层次 图 中 ， 在 同一 层 的 标签 都 是 按照 位 置 关 系 写 在 了 一 起 ， 不 同 层 的 标签 并 不 
下 面 ， 根 据 当 前 “MyFirst Project” 项 目的 AndroidMainfest.xml 文件 进行 分 析 : 


e@ 最 外 层 的 <mainfest> 定义 了 软件 的 属性 ， 如 和 包 路 径 、 程 序 的 版 本 、 版 次 等 等 。 

@ 第 2 层 <application> 定 义 应 用 程序 属性 及 功能 ; 如 android:icon 指定 了 应 用 的 icon 图 
标 ，android:label 定义 了 应 用 程序 的 名 称 ， 并 且 声 明 功 能 <activity> 活 动 。 

@ 第 3 层 是 定义 功能 组 件 的 一 层 ， 如 <activity> 活动 、<receiver> 意 图 与 广播 接受 、 
<service> 服 务 、<provider> 属 性 (内 容 ) 提供 者 ， 都 必须 定义 在 <application> 中 ， 所 以 
这 里 定义 了 <activity> 活 动 类 以 及 活动 类 名 称 。 

@ 第 4 层 <intent-filter> 其 功能 如 一 个 过 滤器 ， 后 文 将 详细 解释 。 

@ 第 5 层 中 的 <action> 定 义 了 意图 动作 的 类 型 ; <category> 是 意图 的 属性 ， 这 里 的 值 
android.intent.category.LAUNCHER 表示 启动 应 用 程序 的 时 候 ， 意 图 将 该 acctivity 显示 
在 屏幕 上 ; 这 种 启动 程序 的 意图 活动 只 能 有 一 个 。 


下 面 详细 介绍 4 种 应 用 程序 的 功能 组 件 。 


2.3.2 ”<activity> 一 Activity (活动 ) 


Android 中 一 个 activity 就 是 一 个 用 户 界面 ， 比 如 手机 拨号 界面 、 通 讯 录 界面 等 都 是 活 
动 。 在 应 用 程序 中 可 以 有 一 个 或 者 多 个 活动 ， 但 是 如 果 新 建 了 一 个 活动 ， 必 须 在 
AndroidManifest.xml 中 进行 声明 。 


2.3.3 ”<receiver> 一 Intent (意图 ) 与 Broacast Receiver (广播 接收 ) 


意图 是 描述 动作 的 机 制 ， 在 Android 手机 中 几乎 都 有 意图 阶段 。 例 如 ， 当 前 有 一 个 “发 
出 一 条 信息 ”的 意图 (Intent) ， 这 时 候 如 果 应 用 程序 需要 发 送信 息 ， 调 用 该 意图 即 可 。 

既然 有 意图 ， 当 然 也 需要 在 应 用 程序 中 注册 一 个 活动 来 处 理 该 意图 ， 那 么 接收 意图 可 称 
为 Broadcast Receiver 〈 广 播 接收 ) ; 举 个 例子 ， 比 如 手机 启动 的 时 候 会 有 一 个 系统 发 出 “ 系 
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统 启动 ”的 意图 ， 只 要 在 应 用 程序 中 注册 活动 来 接受 此 意图 ， 就 可 以 让 其 应 用 程序 在 手机 启 
动 的 时 候 自动 启动 程序 。 因 为 在 Android 中 有 很 多 的 意图 ， 为 了 使 接受 具有 针对 性 ， 可 以 在 
<intent-filter> 中 指定 接收 意图 的 动作 <action>， 因 此 < intent-filter > 的 作用 就 是 一 个 意图 的 过 滤 
器 。 


2.3.4 ”<service> 一 服务 


简单 来 说 ， 就 是 应 用 程序 在 后 台 运行 的 任务 ， 无 需 显示 界面 、 也 不 必 跟 用 户 进行 交互 ， 
但 是 又 需要 长 时 间 在 后 台 进 行 运行 ， 例 如 Android 系统 中 的 音乐 播放 器 ， 当 选 定 歌曲 进行 播 
放 时 ， 即 使 用 户 将 播放 器 应 用 程序 放 入 后 台 ， 然 后 打开 其 他 程序 ， 音 乐 也 会 照常 播放 ， 那 么 
可 以 肯定 播放 器 程序 添加 了 service 服务 功能 。 


2.3.5 ”<provider> 一 Content Provider (内 容 提 供 者 ) 


带 有 内 容 提供 功能 的 应 用 程序 所 进行 的 动作 是 让 使 用 者 可 以 保存 他 们 的 信息 或 文件 ， 例 
如 : Android 手机 联系 人 程序 提供 了 一 个 内 容 提 供 者 ， 任 何 要 使 用 联系 人 信息 的 应 用 程序 都 
可 以 共享 内 容 提供 者 的 所 有 信息 ， 比 如 联系 人 的 姓名 、 电 话 号 、 地 址 等 等 。 

在 AndroidManifestxml 文件 中 除了 以 上 介绍 的 应 用 功能 组 件 之 外 ，Android 对 某 些 关键 
操作 和 访问 都 是 有 权限 来 限制 的 。 假 如 一 个 应 用 程序 需要 将 一 些 数据 保存 到 手机 的 SDCard 
中 ， 那 么 就 需要 在 AndroidManifest 中 设置 添加 写 入 SD 卡 权 限 ， 其 语法 标签 是 <uses- 
permisson>。 例 如 在 “MyFirstProject” 项 目 中 添加 一 条 写 入 SD 卡 的 权限 代码 ， 修 改 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.himi"™ 
android:versionCode="1" 
android:versionName="1.0"> 
<application android:icon="@drawable/icon" android:label= 
"@string/app_name"> 
<activity android:name=".MainActivity" 
android:label= "@string/app_name"> 
…/ /代码 省 略 
</activity> 
</application> 
<uses-permission android:name= 
"android.permission.WRITE EXTERNAL STORAGE"/> 
</manifest> 


<uses-permission> 与 <application> 在 AndroidManifest 语法 中 属于 同一 层次 。 
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2 4 运行 Android 项 目 〈 启 动 Android 模拟 器 ) 


运行 Android 项 目的 方式 概括 起 来 说 有 两 种 : 


1. 直接 运行 Android 项 目 

Eclipse 主 界面 上 ， 在 “Package Explorer” 窗 口中 找到 需要 运行 的 项 目 ， 单 击 项 目 名 称 ， 
然后 单 击 鼠 标 右键 选中 “Run As->Run Configurations” 选 项 ， 进 入 运行 配置 界面 ， 如 图 2-8 
所 示 。 


Create. manage. and run configurations 
Android Application 


i 
上 故 | 日 加 > |Name: New confiauration 


type filter text 


回 Android Applicatio| | 
回 New_configurat | 

8 Android JUnit Test|| | 

@ Eclipse Application || Launch Action: 

Java Applet | @® Launch Default Activi 

© Java Application 

Ju JUnit 

着 JUnit Plug-in Test ||| © Do Nothing 

需 OSGi Framework 


MyFirstProject 


© Launch: 


| parm 


| Filter matched 9 of 17 itenl 


@ 


在 “Run Configurations” 窗 口 的 “Android” 标 签 页 中 单 击 “Browse...” 按 钮 ， 选 中 需要 
运行 的 项 目 ， 然 后 进入 “Target” 标 签 页 中 ， 如 图 2-9 所 示 。 

在 “Run Configurations” 和 窗口 的 “Target” 标 签 页 下 ， 选 择 运 行 设备 的 运行 方式 ， 有 手 
动 和 自动 两 种 ， 然 后 勾 选 已 创建 的 设备 ， 最 后 单 击 “Run” 按 钮 即 可 。 

再 次 运行 项 目 时 ， 不 必 进 入 “Run Configurations ”来 重新 设置 ， 只 需要 在 “Package 
Explorer” 窗 口中 右键 单 击 选中 项 目 名 ， 按照“Run As” 一 “Android Application” 的 步骤 即 
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可 执行 应 用 。 


Create. manage. and run configurations 
Android Application 


| 开国 %| 日 如 > | [Now conGguration 
type filter text | 画 和 ndroid [ee YAEE 
加 aoayegiewoe Deployment Target Selection Mode 
回 New-confguration 。 | 日 Menual ”一 手动 选择 运行 设备 
es 
J Android JUnit Test @ Automatt 


®@ Eclipse Application 自动 选择 运行 _ 
Java Applet Select a preferred Android Virtual Device for deployment 


加 Java Application AVD N.. Target Name Pla.. APL.. || Details.. 
着 JUnis Plug-in Test 
加 OSGi Framework 


Emulator launch parameters: 


| Network Speed: [eu 7 


Fiker matched 9 of 17 items 


@ 


图 2-9 ”Run 配置 一 运行 设备 设置 页 面 


2. 先 启动 模拟 器 ， 再 运行 Android 项 目 


在 SDK&AVD 管理 界面 (如 第 1 章 中 的 图 1-12 所 示 ) ， 选 择 已 经 建立 好 的 AVD， 单 击 
“Start” 按 钮 即 可 启动 模拟 器 〈 头 次 启动 Android 模拟 器 会 有 点 慢 ) 。 

模拟 器 启动 之 后 按照 第 一 种 运行 项 目的 步骤 操作 即 可 。 

运行 的 时 候 要 注意 一 点 : 因为 Android 是 向 下 兼容 ， 所 以 运行 项 目的 时 候 ， 前 提 是 已 经 
创建 了 高 于 或 者 等 于 当前 项 目的 运行 版 本 的 模拟 器 ， 和 否则 在 “Target” 设 备 一 栏 不 会 显示 任 
何 设 备 。 

下 面 比较 一 下 SDK 1.5 模拟 器 与 SDK 1.6 模拟 器 的 UI， 如 图 2-10、 图 2-11 所 示 ， 拿 这 
两 个 来 做 对 比 是 因为 1.6 以 上 版 本 (包含 SDK 1.6) 的 模拟 器 ， 外 观 UI 基本 相同 。 
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图 2-11 Android SDK1.6 (API-4) 模拟 器 UI 


2 .DD 详解 第 一 个 Android 项 目 源码 


运行 “MyFirstProject”， 在 模拟 器 中 显示 的 效果 如 图 2-12 所 示 。 
程序 的 屏幕 结构 如 图 2-13 所 示 。 
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MyFirstProject 


应 用 程序 视图 窗口 


图 2-12 MyFirstProject 运行 效果 图 图 2-13 运行 程序 的 屏幕 结构 图 


通过 屏幕 结构 图 可 以 看 到 ， 当 程序 运行 起 来 之 后 ， 手 机 屏幕 上 不 是 只 有 “应 用 程序 视 
图 ”， 也 会 默认 显示 出 “手机 状态 栏 ” 和 “应 用 名 称 ”， 至 于 如 何 全 屏 运 行程 序 ， 后 续 文 章 
会 有 详细 说 明 ， 这 里 先 来 分 析 第 一 个 Android 程序 的 代码 。 

单 击 “MyFirstProject” 项 目下 存放 源码 的 src 目录 ， 打 开 MainActivityjava 代码 ， 如 图 2- 


14 所 示 。 
1 package com.himi; 
import android.app.Activity; 
3 import android.os.Bundle; 
4 public class MainActivity extends Activity { 
his onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R.layout .main); 
} 
图 2-14 MainActivity 源码 
第 1 行 : 本 类 所 在 的 包 路 径 。 
第 2~3 行 : 引入 相关 类 。 
第 4 行 : 创建 一 个 类 ， 并 继承 Activity 类 。 
第 5 行 : “@Override ”表示 下 面 的 onCreate() 函 数 ( 方 法 ) ， 是 重 写 了 基 类 Activity 
中 的 onCreate0 方 法 ; 如 果 没 有 这 个 标识 ， 编 译 代码 的 时 候 会 认为 这 是 开发 者 
自 定义 的 函数 。 
第 6 行 写 了 Activity 生命 周期 中 的 onCreate() 方 法 。 
第 7 行 : 调用 父 类 的 onCreate(0) 函 数 。 
第 8 行 : 利用 当前 Activity 类 的 setContentView() 来 显示 布局 。 
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通过 上 面 逐 行 对 MainActivity 类 中 代码 的 解释 ， 可 以 看 出 ， 主 要 起 作用 的 代码 就 是 第 8 
行将 R.layout.main 传 入 setContentView() 方 法 中 ， 通 过 Activity 把 布局 显示 在 屏幕 上 。 下 面 我 
们 来 看 看 如 图 2-15 所 示 的 main.xml 布局 文件 中 的 代码 : 


pp» 


<2xml version="1.0" encoding="utf-8"?> 
SxLinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="fill parent" 
android:layout height="fill parent" 


Vv 


<TextView 

android:layout width="fill parent" 
android:layout height="yrap content" 
android:text="@string/hello" 

Ps 

12 </LinearLayout> 


2 
3 
4 
5 
6 
8 
9 
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图 2-15 main.xml 源 码 


第 1 行 : 描述 xml 的 版 本 以 及 编码 格式 。 


第 2 行 : 定义 布局 形式 ，LinearLayout 为 线性 布局 。 

第 3 行 : 设置 布局 位 置 放置 的 类 型 ， 即 “vertical ”垂直 放置 。 

第 4 行 : 设置 布局 的 宽 为 填充 类 型 ， 即 填充 屏幕 。 

第 5 行 : 设置 布局 的 高 为 填充 屏幕 。 

第 6 行 : “>” 布 局 基础 属性 设置 结束 ， 这 里 不 是 结束 布局 ， 到 12 行 才 是 将 布局 结 
束 。 

第 7 行 : 在 布局 中 添加 TextView 组 件 。 

第 8 行 : 设置 TextView 组 件 的 宽 为 填充 类 型 。 

第 9 行 : 设置 TextView 组 件 的 高 为 自 适 应 类 型 ， 即 高 度 根据 其 内 容 自 动 更 改 大 小 。 

第 10 行 : 设置 TextView 组 件 的 文本 内 容 。 

第 11 行 : “/>” 表 示 TextView 设置 结束 ， 也 可 以 写成 “></TextView>”。 


第 12 行 ; 整个 线性 布局 设置 结束 。 
对 于 布局 、 组 件 等 属性 的 设置 格式 一 般 为 : 


《布局 /组 件 名 称 
android: 属 性 =“ 属 性 类 型 ” 


/> 


第 10 行 中 的 “@string/hello”， 这 里 的 “@string” 表 示 索 引 string.xml 中 定义 的 字符 
串 ，“hello” 则 是 在 string.xml 中 定义 字符 串 的 变量 名 ， 对 应 关系 如 图 2-16 所 示 。 
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main. xml : 


android:text="@string/hello”" 


string. xml 


<string name="hello">Hello World, MainActivity!</string> 


图 2-16 ”main.xml 中 引用 string.xml 中 的 字符 串 示意 图 


到 这 里 基本 完成 了 第 一 个 Android 项 目 源码 的 分 析 ， 以 及 每 个 资源 文件 之 间 关 联 关系 的 
介绍 。 可 能 大 家 现在 对 MainActivityjava 这 个 类 中 的 代码 还 是 会 一 头 雾 水 ， 下 面 就 来 详细 介 
绍 一 下 Activity 的 生命 周期 ， 相 信 通 过 Activity 生命 周期 的 讲述 ， 会 使 大 家 思路 清晰 很 多 。 


2 .0 Activity 生命 周期 


在 Android 开发 中 ，Activity 是 非常 重要 的 。Activity 主要 负责 创建 和 显示 窗口 ， 也 可 以 
把 一 个 Activity 理解 成 是 一 个 显示 的 屏幕 ， 在 Android 的 应 用 中 不 是 仅 有 一 个 Activity， 而 是 
可 以 有 多 个 Activity 存在 。 因 其 重要 性 ， 开 发 Android 务必 熟悉 Activity 生命 周期 。 


2.6:1 
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下 面 我 们 先 看 一 张 官方 给 出 的 Activity 生命 周期 图 ， 如 图 2-17 所 示 。 
首先 介绍 Activity 生命 周期 中 的 七 个 函数 : 


onCreate: Activity 初次 创建 时 被 调用 ， 一 般 在 这 里 创建 view、 初 始 化 布局 信息 、 将 
数据 绑 定 到 list 以 及 设置 监听 器 等 等 。 如 果 Activity 首次 创建 ， 本 方法 将 会 调用 
onStart(); 如 果 Activity 是 停止 后 重新 显示 ， 则 将 调用 onRestart()。 

onStart: 当 Activity 对 用 户 即 将 可 见 的 时 候 被 调用 ， 其 后 调用 onResume()。 

onRestart: 当 Activity 停止 后 重新 显示 的 时 候 会 被 调用 ， 然 后 调用 onStart()。 
onResume: 当 用 户 能 在 界面 中 进行 操作 的 时 候 被 调用 。 

onPause: 当 系统 要 启动 一 个 其 他 的 Activity 时 调用 ( 其 他 的 Activity 显示 之 前 ) ， 这 
个 方法 被 用 来 停止 动画 和 其 他 占用 CPU 资源 的 事情 。 所 以 在 这 里 应 该 提交 保存 那些 
持久 数据 ， 这 些 数据 可 以 在 onResume() 方 法 中 读 出 。 

onStop: 当 另 外 一 个 Activity 恢复 并 遮盖 住 当 前 Activity， 导 致 其 对 用 户 不 再 可 见 时 调 
用 。 一 个 新 Activity 启动 、 其 它 Activity 被 切换 至 前 景 、 当 前 Activity 被 销毁 时 都 会 调 
用 此 函数 。 如 果 当 Activity 重新 回 到 前 景 与 用 户 交 互 时 会 调用 onRestart()， 如 果 


Activity 将 退出 则 调用 onDestory()。 


e onDestory: 在 当前 的 Activity 被 销毁 前 所 调用 的 最 后 一 个 方法 ， 当 进程 终止 时 调用 
(对 Activity 直接 调用 Finish 方法 或 者 系统 为 了 节省 空间 而 临时 销毁 此 Activity 的 实 
例 ) 。 


User navigates | 
back to the 


activit 


Another actvity comes] 
in front of he activil 


图 2-17 Activity 生命 周期 图 


为 了 让 大 家 更 清楚 地 看 到 Activity 生命 周期 的 变化 ， 下 面 我 们 把 “MyFirstProject” 项 目 
修改 一 下 ， 对 应 的 源 代码 为 “2-1 (Activity 生命 周期 ) ”， 运 行 效果 如 图 2-18 所 示 〈 这 里 为 
了 给 大 家 讲解 Activity 生命 周期 ， 所 以 如 何 修改 的 代码 暂且 不 做 说 明 ) 。 
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"MyFirstProject 


打开 OtherActivity 


图 2-18 MyFirstProject 修改 后 的 运行 效果 图 


首先 在 “MyFirstProject” 项 目 中 新 添加 了 一 个 类 “OtherActivityjava”， 这 个 类 也 是 一 个 
Activity; 然后 两 个 Activity 类 中 都 重 写 除 了 默认 生成 的 “OnCreate” 函 数 之 外 的 六 个 生命 周 
期 函数 ， 并 在 每 个 生命 周期 函数 中 添加 一 句 Log 打印 语句 ， 然 后 用 “MainActivity” 的 
Activity 打开 新 添加 的 “OtherActivity” 类 中 的 Activity， 从 而 观察 生命 周期 的 变化 和 七 个 函 
数 之 间 的 调用 顺序 。 

Activity 类 中 的 七 个 生命 周期 函数 以 及 每 个 函数 中 打印 的 内 容 如 下 : 

QOverride 
Public void onCreate (Bundle savedInstanceState) { 


super .onCreate (SavedInstanceState) 
setContentView (R.layout .main); 


} 
QOverride 
Protected void onDestroy() { 
super .onDestroy (); 
Log.v("MainActivity", "onDestroy"); 
} 


QOverride 

Protected void onPause() { 
super .onPause(); 
Log.v("MainActivity", "onPause"); 


1 


QOverride 
Protected void onRestart() { 
super .onRestart (); 
Log.v("MainActivity", "onRestart"); 
下 


Q@Override 
Protected void onResume () { 
super .onResume () ; 
Log.v("MainActivity", "onResume"); 
} 


@Override 
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Protected void onStart() { 
super .onStart() 
Log.v("MainActivity", "onStart"); 
} 


Qoverride 
Protected void onStop () { 


super .onStop () 
Log.v("MainActivity", "onStop"); 


运行 项 目 ， 在 LogCat 视图 中 观察 打印 信息 : 
(1) 首先 启动 项 目 进入 MainActivity 类 ， 打 印信 息 如 图 2-19 所 示 。 


03-06 09:29... WV 254 MainActivity conCreate 


03-06 09:29... WV 254 MainActivity onStart 
03-06 09:29... V¥ 254 MainActivit onResume 


图 2-19 启动 项 目的 打印 信息 
(2) 当 单 击 手 机 上 的 “Back” 按 键 ， 打 印信 息 如 图 2-20 所 示 。 


03-06 09:33..，V 254 MainActivity onPause 
03-06 09:33... V¥ 254 MainActivity onStop 
03-06 09:33... VY 254 MainActivity onDestroy 


图 2-20 单 击 “Back” 按 键 的 打印 信息 
(3) “Back” 后 重新 单 击 程序 图 标 进 入 ， 打 印信 息 如 图 2-21 所 示 。 


03-06 09:37... ¥ 254 MainActivity onCreate 
03-06 09:37... WV 254 MainActivity onStart 
03-06 09:37... VY 254 MainActivity onResume 


图 2-21 重新 单 击 程序 图 标的 打印 信息 
(4) 当 单 击 手机 上 的 “Home”【〔 小 房子 ) 按键 ， 打 印信 息 如 图 2-22 所 示 。 


03-06 09:40... VY 254 Mainactivity onPause 
03-06 09:40... V¥ 254 MainActivity onStop 


图 2-22 单 击 “Home” 按 键 的 打印 信息 
(5) “Home” 后 重新 单 击 程序 图 标 进入 ， 打 印信 息 如 图 2-23 所 示 。 


03-06 09:44... 有 254 HainactivIty onRestart 


03-06 09:44... YW 254 MainActivity onStart 
03-06 09:44... 8 254 MainActivitw onResume 


2-23 ”重新 单 击 程序 图 标的 打印 信息 
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以 上 5 种 状态 ， 详 细 地 诠释 了 一 个 Activity 的 生命 周期 。 这 5 种 状态 中 值得 注意 的 是 切 
入 后 台 “Back” 和 “Home” 的 区 别 ， 如 图 2-24 所 示 。 


操作 “Back ”方式 “Hone” 方 式 
将 Activity onPause onPause 
切入 后 台 : onStop onStop 
onDestroy 
将 &ctivity onCreate onRestart 
从 后 台 重 新 onStart onStart 
回 到 前 台 onResume onResume 


图 2-24 Back 与 Home 的 异同 之 处 


2.6.2 ”多 个 Activity 的 生命 周期 


-个 Android 应 用 程序 ， 是 可 以 存在 多 个 Activity 的 ， 下 面 就 来 看 当 存 在 两 个 (或 者 多 
个 ) Activity 的 时 候 ， 每 个 Activity 的 生命 周期 状态 变化 。 
修改 后 的 项 目 运 行 效果 如 图 2-18 所 示 ， 添 加 了 一 个 名 为 button 的 按钮 ， 单 击 这 个 按钮 就 
会 打开 另外 一 个 Activity (OtherActivity〉。 
(1) 在 MainActivity 中 ， 单 击 “button” 按 钮 ， 在 LogCat 视图 中 显示 如 图 2-25 所 示 的 信 
息 。 


MainActivity onPause 
OtherActivity onStart 


Otheractivity onResume 
MainActivity onStop 


图 2-25 单 击 “button ”按键 的 打印 信息 


(2) 当 OtherActivity 打开 之 后 ， 单 击 手机 上 的 “Back” 按 钮 ， 在 LogCat 视图 中 显示 如 
图 2-26 所 示 的 信息 。 


Dtheractivity onPause 
MainActivity onRestart 
MainActivity onStart 


MainActivity onResume 
Dtheractivity onStop 
Dtheractivity onDestroy 


图 2-26 单 击 “Back” 按 键 的 打印 信息 


这 里 ， 可 以 设置 OtherActivity 的 两 种 不 同 展示 类 型 ， 如 图 2-27 所 示 。 
每 个 Activity 都 可 以 设置 它 的 主题 风格 (模式 ) ， 图 2-27 所 示 是 OtherActivity 的 两 种 主 


32 


第 2 章 Hello, Android! 


题 风格 截图 ， 左 边 是 默认 的 主题 风格 ， 右 边 把 风格 设置 成 了 Dialog (对话 框 ) 类 型 。 
两 种 主题 风格 不 同 的 Activtiy 


关闭 当前 Actlvlty 


otherActivity 


图 2-27 OtherActivity 的 两 种 不 同 展示 类 型 
为 什么 要 提 到 这 个 问题 ， 因 为 在 多 个 Activity 之 间 进 行 跳 转 还 需 
另外 的 一 个 Activity， 我 们 要 清楚 另外 一 个 Activity 是 否 能 完全 遮挡 住 
具体 区 别 如 图 2-28 所 示 。 


注意 的 就 是 ， 当 打开 
和 的 Activity 视图 ， 


Activity ( A ) 打开 Activity (B ) 


Yes (默认 主题 模式 ) No 。” (Dialog 主题 模式 ) 
MainActivity onPause MainActivit P. 
不 y onPause 
B 的 视图 是 否 OtherActivity onStart OtherActivity onStart 
能 完全 覆盖 A OtherActivity onResune OtherActivity onResune 
MainActivity onStop 


图 2-28 Activity 主题 模式 不 同 对 比 图 


从 图 2-28 可 以 明显 地 看 出 ， 当 打开 另外 一 个 Activity 的 时 候 ， 还 要 分 析 这 个 新 打开 的 
Activity 会 不 会 将 当前 Activity 完全 覆盖 ， 如 果 不 能 完全 覆盖 ， 则 在 打开 这 个 新 的 Activity 之 
后 ， 之 前 的 Activity 就 不 会 调用 on Stop() 这 个 生命 周期 函数 了 。 

以 上 两 种 状态 是 从 一 个 Activity 跳 转 到 另外 一 个 Activity 的 生命 周期 流程 ， 但 是 这 里 要 注 
意 : 当 第 一 个 Activity 跳 转 到 另外 一 个 Activity 的 时 候 ， 并 没有 在 代码 中 手动 关闭 第 一 个 
Activity。 再 来 看 看 当 打 开 另 外 一 个 Activity 的 时 候 ， 手 动 关闭 之 前 的 Activity 时 ， 两 个 
Activity 的 生命 流程 (在 一 个 Activity 中 ， 只 要 调用 finish0) 函 数 ， 即 可 退出 当前 Activity) 。 

(1) 在 MainActivity 中 单 击 “button” 按 钮 ， 打 印信 息 如 图 2-29 所 示 。 

区 别 很 明显 ， 在 打开 OtherActivity 时 ， 如 果 程 序 中 手动 关闭 了 第 一 个 MainActivity， 那 
么 在 打开 另外 一 个 Activity 之 后 ，MainActivity 在 调用 onStop 之 后 会 多 调用 一 个 onDestory 的 


33 


Android 游 戏 编程 之 从 零 开 始 


MainActivity onPause 
Otheractivity onStart 


Otheractivity onResume 
JainacmivIty onStop 
MainActivity onDestroy 


图 2-29 单 击 “button” 按 钮 的 打印 信息 
(2) 当 OtherActivity 打开 之 后 ， 单 击 手 机 上 的 “Back” 按 钮 打印 信息 如 图 2-30 所 示 。 


¥ 534 OtherActivity onPause 
¥ 534 OtherActivity onStop 


¥ 534 OtherActivity onDestroy 


图 2-30 单 击 “Back” 按 钮 的 打印 信息 


这 个 不 用 多 做 解释 ， 因 为 MainActivity 在 OtherActivity 之 后 就 关闭 掉 了 ， 所 以 程序 中 只 
有 OtherActivity 存在 ， 这 时 候 单 击 “Back” 的 生命 周期 流程 就 如 同 单个 Activity 的 “Back” 
执行 的 生命 周期 流程 。 


2.6.3 Android OS 管理 Activity 的 方式 


前 面 介绍 了 Activity 的 七 个 生命 周期 函数 ， 还 详细 分 析 了 在 多 个 Activity 之 间 跳 转 时 ， 每 
个 Activity 的 生命 周期 流程 。 既 然 每 个 或 者 多 个 Activity 都 可 以 看 成 是 一 个 应 用 程序 ， 那 么 
Android OS 是 如 何 管理 这 些 Activity 的 呢 ? 

对 于 Acticity 的 管理 ，Android 底层 是 用 堆栈 来 存放 Activity 的 ， 也 就 是 说 后 打开 的 
Activity 将 放 入 栈 项 ， 显 示 在 屏幕 的 最 上 层 ， 而 之 前 Activity 则 会 被 新 打开 的 Activity 覆盖 。 
例如 一 个 程序 正在 运行 ， 突 然 手 机 来 电 ，Android 接受 到 来 电 广 播 后 会 打开 一 个 接听 电话 的 
Activity 放 入 堆栈 的 栈 顶 ， 这 样 一 来 运行 的 程序 就 会 被 接听 电话 的 Activity 所 覆盖 。 


2 ./。 Android 开发 常见 问题 


2.7.1 Android SDK 与 Google APls 创建 Emulator 的 区 别 


在 利用 AVD 进行 创建 Android Emulator 时 ， 要 求 选择 SDK 的 版 本 ， 如 图 2-31 所 示 ， 可 
以 看 到 每 个 SDK 版 本 都 对 应 一 个 Google APIs。 
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Android1.6 


Android 1.5 - API Level 3 
Google Apls (Google Inc) - API Level 3 
Android 1.6 - API Level 4 
Google Apls (Google Inc) - Apl Level 4 
Android 2.0 - API Level 5 


图 2-31 Android SDK 与 Google APIsS 对 应 


如 图 2-31 所 示 ，Android 版 本 都 对 应 有 一 个 Google APIs。 其 实 两 种 形式 创建 的 模拟 器 是 
没有 差别 的 ， 只 是 在 Google APIs 中 ，Google 把 自己 提供 的 程序 ， 如 Google Map 放 在 了 
Google APIs 创建 出 来 的 模拟 器 中 。 因 此 ， 如 果 要 开发 Google Map 等 一 些 Google 专属 的 应 用 
程序 ， 就 必须 选用 Google APIs 创建 出 的 模拟 器 。 


2.7.2 将 Android 项 目 导入 Eclipse 


有 时 需要 从 外 部 导入 一 个 Android Project， 有 两 种 导入 方式 : 新 建 Android 项 目 时 导入 和 
直接 导入 。 本 书 中 用 到 的 光盘 中 的 所 有 项 目 例子 ， 都 可 以 通过 这 两 种 方式 导入 。 


1. 新 建 Android 项 目 时 导入 方式 


按照 2.1 节 讲 述 的 创建 Android 新 项 目的 顺序 ， 到 达 图 2-2 所 示 的 “新 建 项 目 配 置 ”这 一 
步 ， 不 填写 任何 信息 ， 按 照 图 2-32 所 示 的 操作 。 


New Android Project 


Project name: MainActivity 


© Create new project in workspace 


加 Create project from existing source |- 一 从 现 有 的 资源 创建 项 目 


Use default location 


| 


Location: CANUsersNHimiNDesktop\MyFirstproject er 
© Create project from existing sample 


项 目 路 径 


Samples: ApiDemos 本 


图 2-32 新 建 项 目 时 导入 项 目 


先 选中 “Create project 人 rom existing source” 单 选 按钮 ， 然 后 单 击 “Browse... ”按钮 选择 
项 目 路 径 ， 最 后 单 击 最 下 方 的 “Finish ”按钮 即 可 。 
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2. 直接 导入 方式 
单 击 Eclipse 菜单 栏 上 的 “File 一 Import” 进 入 导入 方式 选择 界面 ， 如 图 2-33 所 示 。 


Select 
Create new projects from an archive fle or directory. 


Select an import source: 
‘type fiter text 
© General 
BB Archive File 
EB Edsbng Proects mto Workspace 
局 Re System 
加 preferences 
Vs 
EE 
BS Jave EE 
局 Plugiin Development 
BS Remote Systems 
© RuVDebug 
B Tasks 


= 工 


图 2-33 导入 方式 选择 界面 


选中 “Existing Project into Workspace” 选 项， 然后 单 击 “Next” 按 钮 进入 导入 项 目 界 
面 ， 如 图 2-34 所 示 。 


Import Projects 
Select a directory to search for existing Eclipse projects, 


图 2-34 项 目 导入 界面 
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单 击 “Browse… ”按钮 选择 项 目 路 径 即 可 ， 当 前 界面 的 “Copy projects into workspace” 
复 选 框 是 否 选 中 是 可 选 操作 ， 选 中 表示 将 导入 的 项 目 拷贝 到 Eclipse 工作 目录 中 ， 不 选中 则 默 
认 修 改 的 是 导入 的 项 目 。 


2.7.3 在 Eclipse 中 显示 Android 开发 环境 下 常用 的 View 窗口 


在 Eclipse 菜单 一 栏 中 单 击 “Windows 一 Show View 一 Other” 打 开 “Show View” 窗 口 ， 
如 图 2-35 所 示 。 

在 图 2-35 所 示 的 “Show View” 窗 口中 ， 单 击 “Android” 展 开 列 表 项 ， 常 用 到 的 视图 有 
3 个 : “Devices”、“File Explorer” 和 “LogCat”。 

“Devices” 窗 口 如 图 2-36 所 示 。 其 中 ， 图 标 1 用 于 选中 程序 时 ， 单 击 此 图 标 即 可 进入 
Debug 模式 进行 调试 ， 图 标 2 用 于 选中 程序 时 ， 单 击 此 图 标 即 消亡 程序 ， 图 标 3 用 于 截图 ， 
截取 当前 模拟 器 / 真 机 屏幕 。 


Ea)| 


EBDTIETIEETOG GO 


type fiter text 
© General 

4 |B Android 
@ Allocation Tracker 
Devices 当前 模拟 器 / 真 机 设备 
国 Emulator control 
局 File Explorer ~ 一 手机 与 SD 卡 资源 
上 日 Heap 
咀 Layout View 
项 Logcat 查看 调试 信息 
Q pixel Perfect 
A pixel Perfect Loupe 


国 emulator-5554 ”设备 
em pre 
com.android.phone 
android.process.acore 
android.process.media 
com.himi 
com.android.alarmclock 
comandroidmms 
com.svox.pico 


Q pixel Perfect Tree com.androidjnputmethodjatin 


忌 Resource Explorer 
总 Threads 

"3 Tree Overview 

喇 Tree View 

"34 View Properties 
Pp 


当前 设备 正在 运行 的 程序 


Use F2 to display the description for a selected view. 


E> 
2-35 选择 视图 View 图 2-36 Devices 视图 


“File Explorer” 视 图 如 图 2-37 所 示 。 如 果 当 前 设备 没有 安装 SD 卡 ， 则 不 会 有 
“sdcard” 一 项 。 图 中 ， 图 标 1 用 于 当选 中 文件 时 单 击 此 图 标 表示 导出 文件 ， 图 标 2 用 于 当 
选中 文件 时 单 击 此 图 标 表示 导入 文件 ， 图标 3 用 于 当选 中 文件 时 单 击 此 图 标 表 示 删 除 此 文 
件 。 

“LogCat” 窗 口 如 图 2-38 所 示 ， 这 个 窗口 用 于 显示 项 目 运行 时 的 打印 信息 等 。 
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Ur] 
Re ©®QOOOOl+B-| 国 ”| 
| & Hd 
Name 1 3 
dat 手机 内 存 pid tag ~ 
外 sdcard~ 一 手机 中 的 SD 卡 I 1521 dalvikvn | 
= D 1521 dalvikvm 
4 GB system 3 
i I 52 activityManager | | 
Ps: D 1521 dalvikvm 
Pb D 30 dalvikvn 
时 build,prop I 1530 jdwp 
"etc D 1530 ddn-heap 
, BS fonts D 30 dalvikvn 
timewadk D 30 dalvikvn 
lib ¥ 1530 MainActivity 
¥ 1530 MainActivity 
leon ¥ 1530 MainActivity 
Dd W 52 InputManagerS 
BS usr I 52 ActivityManager 
© xbin D 112 dalvikvm 
WW 1530 ] 
] 1530 
上 
图 2-37 File Explorer 视图 图 2-38 LogCat 视图 


2.7.4 在 Eclipse 中 利用 打印 语句 〈Log) 调试 Android 程序 


在 调试 程序 时 ， 偶 尔 会 添加 打印 信息 来 掌握 当前 程序 的 运行 状态 。 之 前 在 介绍 Activity 
生命 周期 的 时 候 ， 已 经 使 用 了 打印 语句 Log.v0， 这 里 简单 介绍 一 下 Log 打印 语句 。 
在 Android 中 一 般 常用 的 打印 语句 有 五 种 : 


Log.v (黑色 ) : 任何 消息 都 会 输出 ， 一 般 都 利用 这 个 打印 来 进行 观察 程序 运行 状 
况 ; 
Log.i (绿色 ) : 输出 的 是 提示 性 的 信息 ; 
Log.d ( 蓝 色 ) : 只 输出 Debug 的 信息 ; 
Log.w (黄色 ) : 输出 警告 信息 ; 
Log.e (红色 ) : 输出 错误 信息 。 
- 般 情 况 下 ， 使 用 Log.v0 进 行 打印 。 要 注意 一 点 ， 通 常 执行 打印 语句 会 在 “LogCat” 视 


图 中 看 到 打印 出 的 信息 ， 但 有 时 候 会 发 现 程序 中 明明 写 了 输出 语句 ， 而 且 也 确实 能 执行 到 ， 
可 是 “LogCat” 视 图 中 就 是 不 显示 打印 的 信息 ， 这 种 情况 的 解决 办 法 就 是 : 在 “Devices” 视 
图 中 单 击 运行 的 程序 ，“LogCat” 视 图 中 就 会 显示 打印 的 信息 了 。 这 是 因为 “LogCat” 默 认 
显示 输出 的 是 整个 模拟 器 的 运行 状态 ， 只 有 在 “Devices” 视 图 中 单 击 〈 指 定 ) 到 程序 上 ， 
“LogCat” 视 图 才 会 输出 程序 的 打印 信息 。 
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2.7.5 在 Eclipse 中 真 机 运行 Android 项 目 


将 Android 手机 通过 USB 线 连接 到 电脑 上 ， 然 后 在 手机 上 选中 “USB 调试 ”选项 ， 之 后 
在 电脑 上 安装 对 应 手机 的 驱动 ， 这 样 在 Eclipse 的 “Devices” 视 图 中 就 会 显示 出 真 机 设备 
了 。 如 果 想 运行 项 目 在 手机 上 ， 只 要 在 “Run Configurations ”窗口 (如 图 2-9 所 示 ) 下 的 
“Target” 页 面 下 选中 “Manual” 【手动 选择 运行 设备 ) ， 然 后 在 Run 的 时 候 ， 手 机 设备 如 
果 正 常 连接 ， 将 会 弹出 “Android Device Chooser” 窗 口 ， 如 图 2-39 所 示 。 
加 Tod De Chao 


Select a device compatible with target Android 1.6. 
@® Choose a running Android device 


[ Debug State 
| SHoewpLoss67 N/A ft 232 Yes Online 


L 
Launch a new Android Virtual Device 


AVD Name Target Name 


android1.6 Android 1.6 
android20 Android 20 


图 2-39 真 机 运行 Android 项 目 
在 “Android Device Chooser” 窗 口中 ， 选 中 真 机 设备 ， 最 后 单 击 “OK ”按钮 运行 。 


2.7.6 设置 Android Emulator 模拟 器 系统 语言 为 中 文 


默认 模拟 器 系统 语言 为 英文 ， 设 置 系统 语言 的 具体 步骤 为 : 单 击 运行 设备 上 的 “Menu 一 
Settings 一 Locale & text 一 Select locale” 菜 单项 ， 然 后 选择 “简体 中 文 ” 即 可 设置 系统 语言 为 
中 文 。 


2.7.7 ”切换 模拟 器 的 输入 法 


切换 模拟 器 的 输入 法 的 操作 步骤 如 图 2-40 所 示 。 单 击 输入 控件 直到 弹出 “Edit text” 对 
话 框 后 释放 和 鼠标， 然后 单 击 “Input Method” 菜 单 进入 选择 输入 法 窗口 界面 ， 选 中 “谷歌 拼音 
输入 法 ” 即 可 输入 中 文 。 
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1 长 而 间 点 击 控件 
一 ue 3. 然后 泊 出 莹 入 法 园 拌 对 旋 框 ， 选 勾 迁 即 可 。 
rr 


2， 在 询 淖 的 Nj 话 左 中 选 摊 “Input Method= 


© Edittext 
Input Method 


图 2-40 切换 输入 法 流程 图 


2.7.8 ”模拟 器 中 创建 SD Card 


游戏 开发 中 有 时 会 保存 一 些 数据 到 SD Card 中 ， 或 是 从 SD Card 中 获取 数据 。 本 小 节 将 
介绍 在 Android Emulator 〈 模 拟 器 ) 中 如 何 创建 SD Card。 
在 模拟 器 上 创建 SD Card 其 实 很 简单 ， 只 需要 在 之 前 利用 AVD 创建 Android 模拟 器 的 时 
候 ， 稍 微调 整 配置 就 可 以 了 ， 有 具体 方法 为 《如 图 2-41 所 示 ) : 
@ 输入 SDcard 大 小 (至少 要 9M) ， 这 里 是 以 
MB 为 单位 。 
@ 在 “Hardware” 列 表 框 下 单 击 “New” 按 
钮 ， 添加 “SD Card support” 一 一 SD Card 
硬件 支持 。 


Target ”|Android 16-APlLevel4 


SD Card: 


2.7.9 ”模拟 器 横竖 屏 切换 

模拟 器 横竖 屏 切换 的 方法 是 同时 按 下 电脑 键盘 
的 “Ctrl” 和 “F111” 两 个 按键 ,或 者 同时 按 下 
“Ctrl” 和 “F12” 也 可 以 。 


r 
Prop Value [he 
SD Card support 1 = 


Abstracted LCD density 160 


aneocauafat ”上 2.7.10 打包 Android 项 目 


Override the existing AVD with the same name 所 有 的 Android 应 用 程序 都 以 “.apk” 为 后 缀 命 
名 一 个 安装 包 ， 这 个 apk 包 中 包含 应 用 编译 后 源码 、 
资源 文件 、 应 用 的 版 本 信息 、 用 到 的 权限 等 等 。 


[ceeeA ] [concel | 在 Android 系统 的 手机 上 安装 apk 文件 的 时 
候 ， 其 应 用 程序 不 仅 用 到 “.apk” 为 后 组 的 文件 ， 
图 241 创建 SDcard 而 且 还 必须 利用 数字 证 书签 名 后 才 可 安装 到 手机 或 
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者 模拟 器 上 。 
所 谓 给 程序 “签名 ”， 其 实 就 是 标识 应 用 程序 的 作者 和 应 用 程序 之 间 建 立信 任 关系 ， 是 
一 种 维护 知识 产权 的 方式 ; 当然 数字 证 书 也 不 需要 权威 认证 ， 它 是 应 用 程序 自我 认证 的 。 
那么 说 到 这 里 ， 大 家 会 有 疑问 : 为 什么 在 Eclipse 中 运行 项 目的 时 候 ， 模 拟 器 和 真 机 都 可 
以 正常 调试 和 运行 呢 ? 其 实 当 运行 一 个 Android 项 目的 时 候 ， 内 置 的 ADT 插件 会 用 内 置 的 调 
试 证 书 给 程序 进行 打包 签名 ， 然 后 再 安装 到 真 机 或 者 模拟 器 上 运行 ;但 是 如 果 想 将 程序 正式 
发 布 的 话 ， 就 不 能 使 用 调试 的 证 书签 名 ， 必 须 用 正式 的 签名 才 可 以 。 


1 . Android 程序 打包 和 签名 


下 面 讲解 如 何 将 Android 程序 打包 并 对 其 签名 。 
在 Eclipse 中 鼠标 右键 单 击 需要 打包 的 Android 项 目 ， 然 后 选中 “Android Tools” 级 联 菜 
单 ， 如 图 2-42 所 示 。 


加 沉 Dows 起 Jme [De] 


SD Oevices 三 


2-42 选择 打包 步骤 


在 如 图 2-42 所 示 的 菜单 中 ，“Export Sigend Application Package... ”选项 表示 签名 打 
包 ; “Export Unsigned Application Package...” 选 项 表示 不 签名 打包 。 两 种 签名 方式 的 具体 
步骤 说 明 如 下 : 

(1) 签名 打包 

单 击 “Export Signed Application Package... ”选项 进入 签名 打包 的 第 一 个 窗口 “Export 
Android Application”， 如 图 2-43 所 示 。 
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Project Checks 2 
La 


TY 


Performs a set of checks to make sure the application can be exported 


Select the project to export 


Project MyFirstproject Browse.. 
No errors found. Click Next. 


图 2-43 ”签名 打包 一 选择 打包 项 目 


单 击 “Browse…” 按 钮 选择 打包 的 项 目 ， 然 后 单 击 “Next” 按 钮 进入 如 图 2-44 所 示 的 界 
面 。 


Keystore selection 


© Use existing keystore 
Create new keystorel 


Location: “123456.key ”证 书 文件 名 称 
Password: eeeeee 密码 


Confirm: weeeee 密码 确认 


Next > Enish | [ 


2-44 签名 打包 一 新 建 数字 证 书 


在 图 2-44 所 示 的 界面 中 ， 选 中 “Create new keystore” 单 选 按钮 〈 新 建 一 个 数字 证 书 ) ， 
输入 证 书 名 称 和 密码 ， 然 后 单 击 “Next” 按 钮 进入 设置 证 书信 息 界面 ， 如 图 2-45 所 示 。 
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Key Creation Ey 
I 
3 

Alias: 123456 证 书 别名 

Password: ee 别名 证 书 密码 

Confirm: ee 别名 证 书 密码 

Validity (years): 100 证 书 有 效 期 限 ( 年 ) 

First and Last Name: Himi 作者 


Organizational Unit: 


开发 单位 《可 选 填 ) 


Organization: 


开发 团队 《可 选 十) 


City or Locality: 


城市 或 地 区 《可 选 十) 


State or Province: 


国家 或 省 份 ” 《可 选 十) 


Country Code 000: 


国家 代码 (可 选 十 ) 


@ grish ] [cence 
图 2-45 签名 打包 一 一 证 书信 息 设 置 
填写 好 证 书信 息 之 后 ， 单 击 “Next” 按 钮 出 现 签名 打包 的 最 后 一 个 界面 ， 如 图 2-46 所 


五 Export Android Ap 


| Destination and key/certificate checks 


Destination APK file: C:\Users\Himi\Desktop\MyFirstProject.apk 


Certificate expires in 100 years, 


2-46 签名 打包 一 一 选择 导出 的 apk 包 路 径 
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(2) 非 签名 打包 
在 如 图 2-42 所 示 的 级 联 菜单 上 ， 选 中 “Export Unsigned Application Package...” 选 项 ， 
然后 直接 选择 打包 后 apk 的 保存 路 径 即 可 。 


到 小 技巧 


有 些 时 候 需要 将 自己 的 程序 在 真 机 上 安装 或 者 给 朋友 拿 去 测试 ， 试 玩 一 下 ， 难 道 只 能 
通过 签名 打包 才 行 么 ? 


不 用 。 虽 然 程序 在 非 签名 打包 时 无 法 在 真 机 和 模拟 器 上 运行 ， 但 是 ， 在 讲解 两 种 打包 之 
前 曾经 解释 过 ， 当 Android 项 目 每 次 运行 时 ，ADT 其 实 都 会 为 程序 利用 调试 签名 进行 打包 ， 
也 就 是 说 只 要 项 目 运行 过 ， 就 会 有 一 个 apk 生成 了 ; 这 个 由 ADT 调试 签名 的 apk 其 实 就 在 项 
目下 的 bin 文件 夹 里 ，bin 文件 夹 在 Eclipse 的 项 目 结构 中 是 看 不 到 的 ， 可 以 直接 到 文件 系统 
中 查找 ， 例 如 MyFirstProject 项 目 中 由 ADT 调试 签名 的 apk 路 径 为 “eclipse_workspace 
(Eclipse 的 工作 路 径 ) \MyFirstProject\bin\MyFirstProjectapk”， 这 个 APK 虽然 不 能 正式 发 布 
出 去 ， 但 是 使 用 很 方便 。 


2. 安装 、 卸 载 APK 文件 


这 里 先 介 绍 一 下 ADB (Android Debug Bridge) 工具 。ADB 是 Android SDK 自 带 的 工 
具 ， 使 用 这 个 工具 可 以 直接 操作 管理 Android 模拟 器 或 者 真实 的 Andriod 设备 。 

音 助 ADB 工具 ， 可 以 安装 和 务 载 程序 ， 将 Android 设备 的 文件 导出 到 PC 上 ， 也 可 以 将 
PC 文件 导入 Android 设备 中 等 等 。 简 单 地 说 ，ADB 其 实 就 是 Android 设备 与 PC 之 间 的 一 个 
桥梁 ， 通 过 ADB 可 以 更 全 面 地 对 Android 设备 进行 操作 。 

那么 ， 如 何 使 用 ADB 命令 来 进行 安装 和 印 载 APK 程序 呢 ? 

首先 ， 打 开 DOS 窗口 ， 将 目录 转 到 SDK 中 的 adb.exe 所 在 的 目录 中 。 例 如 ， 作 者 电脑 的 
adb.exe 当前 路 径 是 Di\android-sdk-windows\tools， 如 图 2-47 所 示 。 


ID :sandroid-sdk-windowsNtools>adhb install d:Ntest_-apk 
[765 KB/s 《13328 bytes in @.817?s> 


pkg: /data/local/tmp/test .apk 


Success 
图 2-47 作者 电脑 的 adb.exe 当前 路 径 
然后 假设 “D:\” 根 目录 下 有 一 个 “test.apk” 文 件 ， 我 们 使 用 ADB 命令 来 对 其 进行 安装 
和 外 载 操作 ， 在 安装 或 删除 程序 之 前 要 确定 当前 是 否 有 一 个 模拟 器 在 运行 。 
安装 命令 为 adb install [apk 路 径 ]， 如 图 2-48 所 示 。 


D:\android-sdk-windows \tools>adb install d:Ntest -apk 
?65 KB/s 《13328 bytes in @.0617?7s> 


pkg: /data/local/tmp/test -apk 
Success 


图 248 安装 命令 
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卸载 命令 为 adb unstall [程序 的 包 路 径 ]， 如 图 2-49 所 示 。 


D:\android-sdk-windows \tools>adb uninstall com.himi 


Success 


图 249 钾 载 命令 


需要 注意 ， 卸 载 程序 时 使 用 的 程序 名 不 是 安装 时 apk 的 文件 名 ， 而 是 程序 的 包 名 。 
每 次 想 删除 和 安装 一 个 apk 程序 的 时 候 都 要 去 先 转 到 ADB 所 在 路 径 很 麻烦 ， 其 实 只 须 将 
ADB 所 在 路 径 配 置 到 电脑 的 环境 变量 中 即 可 。 


本 章 小 结 


本 章 介绍 如 何 创建 Android 项 目 ， 熟 悉 Android 项 目 结构 ， 详 细 训 析 Android 开发 中 最 了 
要 的 Activity 的 生命 周期 以 及 常见 的 问题 解答 等 。 

本 章 的 重点 是 Activity 的 生命 周期 。 作 为 一 个 Android 开发 者 ， 不 仅仅 需要 会 使 用 
Android API 来 进行 应 用 的 开发 ， 更 应 该 将 Activity 的 生命 周期 融会 贯通 。 


峡 \ 
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从 本 章节 可 以 学 习 到 : 

学 Button 学 ProgressBar 

学 Layout 学 SeekBar 

党 ImageButton 学 TabSpec 与 TabHost 
党 EditText 学 ListView 

党 CheckBox 学 Dialog 


学 RadioButton 学 ”系统 控件 常见 问题 
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手机 应 用 开发 中 ， 不 论 基于 哪个 平台 ， 软 件 基 本 都 是 利用 系统 控件 (组 件 ) 做 开发 ， 虽 
然 系统 组 件 很 多 ， 但 游戏 开发 中 很 少 用 到 ; 在 游戏 开发 中 一 般 自 定义 〈 代 码 实现 ) 符合 游戏 
题材 的 组 件 ， 因 为 游戏 除了 丰富 的 玩法 之 外 ， 最 注重 的 就 是 界面 (UI〉， 如 果 也 都 利用 系统 
组 件 做 开发 ， 那 游戏 就 会 趋 于 单调 ， 让 玩家 感到 审美 疲惫 ; 但 是 在 开发 中 我 们 也 难免 会 去 跟 
系统 组 件 打交道 ， 所 以 这 一 章 向 大 家 讲解 一 些 比较 基本 、 常 用 的 系统 组 件 。 

这 里 需要 提醒 读者 ， 为 了 简化 篇 幅 、 便 于 讲解 ， 新 建 一 个 项 目 时 都 不 会 去 截图 和 讲述 是 
如 何 创建 该 项 目的 ， 所 以 在 这 里 定 下 一 条 规则 : 只 要 是 新 建 项 目 ， 如 没有 特殊 说 明 的 都 默认 
活动 名 (application name) 为 “MainActivity”。 


3 1 Button 


Button〈 按 钮 ) 是 一 个 常用 的 系统 小 组 件 ， 很 小 但 是 在 开发 中 最 常用 到 。 一 般 通 过 与 监 
听 器 搭配 使 用 ， 从 而 触发 一 些 特定 事件 。 下 面 来 新 建 一 个 项 目 “ButtonProject”， 对 应 的 源 
代码 为 “3-1 (Button 与 点 击 监 听 器 ) ”。 

在 上 一 章 中 已 经 介绍 过 ， 当 新 建 一 个 Android 项 目 时 ，ADT 会 自动 生成 一 个 文本 视图 
(TextView) 组 件 ， 并 显示 在 屏幕 上 ， 那 么 现在 再 来 添加 一 个 Button。 

打开 “res-layout” 下 的 main.xml 与 string.xml， 修 改 代码 如 下 所 示 : 


main.xml : 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="fill parent™" 
android:layout height="fill parent" 
> 
<TextView 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="@string/hello" 
/> 
<Button 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text=" 态 人 忽 " 
/> 
<Button 
android:layout width="wrap content" 
android:layout height="fill parent" 
android:text="@string/btn cancel" 
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从 
</LinearLayout> 


string.xml: 


<?xml version="1.0" encoding="utf-8"?> 


<resources> 
<string name="hello">Hello World, MainActivity!</string> 


<string name="app name">ButtonProject</string> 
<string name="btn cance1"> 取 消 </string> 
</resources> 


这 里 新 添加 了 两 个 Button， 且 定义 了 每 个 Button 的 宽 高 和 文本 属性 ， 但 是 这 两 个 Button 
是 有 区 别 的 ， 其 中 定义 两 个 Button 的 宽 高 样式 正好 相反 。“wrap_content” 表 示 是 自 适应 文 
本 宽度 样式 ，“fill_parent” 是 全 部 填充 样式 ， 可 能 这 么 说 不 太 容易 理解 ， 在 下 文 看 到 运行 效 
果 后 再 继续 讲解 。 

另外 一 点 区 别 就 是 “android: text” 这 个 文本 属性 的 赋值 书写 形式 不 一 样 。 其 实 这 里 想 说 明 
的 是 ， 字 符 串 的 定义 不 是 一 定 要 到 string.xml 文件 中 定义 ， 而 后 利用 “@string/ ”形式 去 索引 
string.xml 中 定义 的 字符 串 变量 并 对 其 进行 赋值 ， 字 符 串 也 可 以 直接 在 定义 组 件 属性 时 进行 赋值 。 

String 标签 的 其 他 地 方 都 不 需要 修改 ， 查 看 一 下 运行 效果 ， 如 图 3-1 所 示 。 


咒 硬 大 3:11PM 


图 3-1 两 个 Button 


在 图 3-1 所 示 的 界面 中 ，Android 在 解析 布局 文件 的 时 候 是 从 上 往 下 来 进行 的 ， 也 就 是 
说 先 定义 的 组 件 将 先 被 显示 出 来 ; 那么 在 布局 文件 中 ， 可 以 看 到 定义 组 件 的 顺序 依次 为 
“TextView”、 按 钮 (确定 ) 、 按 钮 (取消) ， 所 以 屏幕 上 先 显示 的 是 新 建 项 目 自动 生成 的 
“TextView” 文 本 组 件 ， 接 着 是 定义 的 “确定 ”与 “取消 ”按钮 组 件 。 

“确定 ”按钮 在 定义 的 时 候 ， 宽 为 “fill_parent” 填 充 样式 ， 所 以 它 的 宽 占 了 整个 屏幕 ， 
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高 定义 为 “wrap_content” 自 适应 文本 样式 ， 所 以 其 高 度 正好 包 训 了 “确定 ”字体 ; “取消” 
按钮 的 宽 高 定义 的 样式 正好 与 “确定 ”按钮 相反 ， 记 以 其 宽度 正好 是 包 庄 在 “取消 ”字体 ; 
高 度 则 是 填充 整个 屏幕 ， 但 是 因为 “确定 ”按钮 显示 的 时 候 已 经 占 了 一 定 高 度 ， 所 以 “ 取 
消 ” 按 钮 的 高 度 没有 占 满 屏幕 。 

上 面 添加 的 两 个 按钮 虽然 可 以 点 击 ， 但 是 没有 任何 的 效果 。 下 面 对 两 个 按钮 添加 点 击 事 
件 ， 使 “确定 ”按钮 点 击 后 改变 “TextView” 的 文本 信息 为 “确定 按钮 触发 事件 ! ”， 并 且 
点 击 “ 取 消 ” 按 钮 后 改变 “TextView” 的 文本 信息 为 “取消 按钮 触发 事件 ! ”。 


到 王 了》 在 布局 中 给 每 个 组 件 都 新 声明 ID 属性 。 


当 需 要 在 源 代码 中 获取 到 在 布局 中 定义 的 这 3 个 组 件 时 ， 要 给 3 个 组 件 添 加 ID 属性 。 
main.xml 代码 修改 如 下 : 


<?xm]l version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android™" 
android:orientation="vertical”" 
android:layout width="fill parent" 
android:layout height="fill parent" 
> 
<TextView 
android:layout width="fill Parent" 
android:1layout height="wrap content" 
android:text="@string/hello" 
android:id="@+id/tv" 
人/ 
<Button 
android:layout width="fill parent" 
android:1layout height="wrap content" 
android:text=" 硼 仑 " 
android:id="@+id/btn ok"™ 
/> 
<Button 
android:layout width="wrap content" 
android:layout height="fill parent" 
android:text="@string/btn cancel" 
android:id="@+id/btn cancel" 
/> 
</LinearLayout> 


给 组 件 添加 ID 属性 ;定义 格式 为 android: id=“@+idname”， 这 里 的 name 是 自 定义 
的 ， 不 是 索引 变量 。“@+ ”表示 新 声明 ，“@” 则 表示 引用 ， 例 如 : 


e “@+id/tv” 表 示 新 声明 一 个 jd， 是 id 名 为 tv 的 组 件 ; 
。 “@id/tv” 表 示 引 用 id 名 为 tv 的 组 件 。 
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为 每 个 组 件 添加 好 新 声明 的 ID 之 后 ， 在 源 代码 中 通过 R 资源 就 可 以 引用 到 ， 然 后 修改 
MainActivity.java 文件 ， 源 代码 如 下 : 


Package com.himi.button;// 包 路 径 
//import 导入 类 库 
import android.app.Activity; 
import android.os.Bundle; 
import android.widget .Button; 
import android.widget.TextView; 
public class MainActivity extends Activity { 
Private Button btn ok，btn cancel;// 声 明 两 个 按钮 对 象 
Private TextView tv; // 声 明文 本 视图 对 象 
@Override 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 
// 对 btn_ok 对 象 进行 实例 化 
btn ok = (Button) findViewById(R.id.btn ok); 
// 对 btn_cancel 对 象 进行 实例 化 
btn cancel = (Button) findViewById(R.id.btn cancel); 
// 对 tv 对象 进 行 实例 化 
tv = (TextView) findViewById(R.id.tv); 


关于 导入 类 库 有 3 种 方式 : 


e@ 手动 import ， 例 如 声明 一 个 Button， 手 动 “import android.widger.Button”; 

@ 声明 类 型 的 时 候 ， 由 Eclipse 自动 补 全 ， 并 自动 导入 包 。 例 如 声明 一 个 Button， 写 
Button 类 型 的 时 候 写成 “Butto” 这 里 故意 将 Button 这 个 类 型 单词 不 写 全 ， 然 后 利用 
键盘 组 合 键 “Altt/” 自 动 完成 ; 

@ 使 用 导 包 快捷 键 : 利用 组 合 键 “ShifttCtrl+O” 快 速 完 成 导入 。 先 声明 两 个 Button 与 
一 个 TextView 对 象 ， 然 后 通过 findViewById (int id ) 的 方法 引用 在 布局 文件 中 定义 
的 组 件 并 且 对 其 进行 实例 化 。 


给 按钮 添加 点 击 事件 响应 。 


想 知道 按钮 是 否 被 用 户 点 击 ， 就 需要 一 个 “点 击 监 听 器 ”来 对 其 进行 监听 ， 然 后 通过 监 
听 器 来 获取 点 击 的 事件 ， 就 可 以 判定 关注 的 按钮 是 否 被 用 户 所 点 击 。 

使 用 监听 器 有 两 种 方式 : 

(1) 当前 类 使 用 点 击 监听 器 接口 ， 修 改 后 源 代码 如 下 : 


// 使 用 点 击 监听 器 
public class MainActivity extends Activity implements OnClickListener{ 
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Private Button btn ok, btn cancel; 

private TextView tv; 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedIinstanceState); 
setContentView(R.layout.main); 
btn ok = (Button) findViewById(R.id.btn ok); 
btn cancel = (Button) findViewById(R.id.btn cancel); 
tv = (TextView) findViewById(R.id.tv); 
// 将 btn_ok 按钮 绑 定 在 点 击 监听 器 上 
btn ok.setOonClickListener (this); 
// 将 btn_cancel 按钮 绑 定 在 点 击 监听 器 上 


btn cancel.setOnClickListener (this); 


} 
// 使 用 点 击 监听 器 必须 重 写 其 抽象 函数 ， 
//aoverride 表示 重 写 函 数 
QOverride 
Public void onClick(View v) { 
二 (7 == btnrok)t 
tv. setText ("确定 按钮 触发 事件 ! "); 
}else if(v == btn cancel){ 
tv.setText ("取消 按钮 触发 事件 ! ") 


先 用 当前 类 使 用 点 击 监听 器 接口 (onClickListener) ， 重 写 点 击 监 听 器 的 抽象 函数 


(2) 使 用 内 部 类 实现 点 击 监听 器 进行 监听 ， 修 改 后 源 代码 如 下 : 


Public class MainActivity extends Activity{ 


Private Button btn ok, btn cancel; 

Private TextView tv; 

@Override 

Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
btn ok = (Button) findViewById(R.id.btn ok); 
btn cancel = (Button) findViewById(R.id.btn cancel); 
tv = (TextView) findViewById(R.id.tv); 
// 将 btn_ok 按钮 绑 定点 击 监听 器 


(ConClick) ;然后 对 需要 监听 的 按钮 进行 按钮 绑 定 监听 器 操作 ， 这 样 监听 器 才能 对 绑 定 的 按 
- 旦 有 按钮 被 点 击 ， 就 会 自动 响应 onClick 函数 ， 

并 将 点 击 的 button (button 也 是 1 个 view) 传 入 ; 最 后 就 可 以 在 onClick 函数 中 书写 点 击 会 触 
发 的 事件 (因为 定义 了 多 个 按钮 ， 所 以 在 onClick 函数 中 对 系统 传 入 的 view 进行 按钮 匹配 的 
判断 ， 让 不 同 的 按钮 做 不 同 的 处 理事 件 )。 
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btn ok.setonClickListener (new OnClickListener() { 
@Override 
public void onClick(View arg0) { 
tv .setText (" 确 定 按钮 触发 事件 ! ") ; 
上 
]) 7 
// 将 btn_cancel 按钮 绑 定点 击 监听 器 
btn cancel.setOnClickListener (new OnClickListener () { 
@Override 
public void onClick(View arg0) { 
tv.setText ("取消 按钮 触发 事件 !"); 
Ws 


利用 内 部 类 的 形式 也 需要 重 写 点 击 监听 器 的 抽象 函数 ， 然 后 在 onClick 里 进行 处 理事 
件 ， 这 里 不 用 判断 view 了 ， 因 为 一 个 Button 对 应 了 一 个 监听 器 。 


门 


2。 2 Layout 


这 里 首先 开始 讲解 布局 管理 的 原因 在 于 ， 系 统 控件 一 般 都 会 搭载 进 布局 中 ， 让 Layout 进 
行 管 理 和 规整 组 件 的 位 置 ， 然 后 只 要 需 通过 Activity 去 显示 一 个 布局 ， 那 么 布局 中 搭载 的 组 
件 就 都 一 并 显示 在 手机 屏幕 上 了 。Android 提供 了 5 种 布局 类 型 ， 通 过 这 5 种 布局 之 间 的 相互 
组 合 可 以 构建 各 种 复杂 的 布局 ， 五 种 布局 对 应 的 源 代 码 为 “3-2 (Layout 布局 ) ”。 


3.2.1 ”线性 布局 


LinearLayout〔 线 性 布局 ) 是 5 种 布局 中 最 常用 的 一 种 ， 此 布局 在 显示 组 件 的 时 候 会 默认 
保持 组 件 之 间 的 间隔 以 及 组 件 之 间 的 互相 对 齐 〈 相 对 一 个 组 件 的 右 对 齐 、 中 间 对 齐 或 者 左 对 
齐 ) 。 线 性 布局 显示 组 件 的 方式 有 垂直 与 水 平 两 种 ， 可 以 通过 orientation 进行 设 定 。 

新 建 一 个 项 目 ， 然 后 在 布局 文件 Cmain.xml) 中 添加 3 个 名 字 不 同 但 其 他 属性 都 相同 的 
按钮 组 件 。 

修改 后 的 main.xml: 

<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:orientation="vertical" 
android:layout width="fill parent" 
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android:layout height="fill _ parent" 


> 
<Button 


android: 
android: 
android: 


/> 
<Button 
android 


Ww 
<Button 


android:layout width="fill parent" 
android: 


android: 


Je 
</LinearLayout> 


orientation 属性 表示 设置 布局 中 的 控件 的 方向 ， 其 属性 值 有 两 种 ， 
-种 是 “horizontal” 水 平 排列 。 这 里 设置 成 了 垂直 排列 ， 宽 高 都 设置 成 了 填充 的 
行 项 目 后 的 效果 如 图 3-2 所 示 。 


直 排列 ， 另 
形式 。 运 


layout width="fill parent" 
layout height="wrap content" 
text="Buttonl" 


:layout width="fill parent" 
android: 
android: 


layout height="wrap content" 
text="Button2" 


layout height="wrap content" 
text="Button3" 


动 而 拓 6:09PM 


[LayoutPro 


Btutton2 


图 3-2 线性 布局 方式 一 垂直 显示 组 件 


-种 是 “vertical” 生 


在 图 3-2 中 可 以 看 到 3 个 按钮 组 件 都 依次 垂直 排列 的 ， 那 么 如 果 将 布局 的 orientation 属 
性 设置 成 水 平方 式 ， 项 目 运行 效果 如 图 3-3 所 示 。 


EECSEDT | 


earLayoutProject 


Btutton1 


3-3 ”线性 布局 方式 -水 平 显示 组 件 
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这 里 只 有 1 个 Button 显示 在 屏幕 中 ， 其 实 剩 下 的 2 个 按钮 组 件 不 是 没有 显示 ， 而 是 显示 
在 了 Buttonl 的 右 侧 ， 因 为 定义 的 每 个 按钮 组 件 的 宽 都 是 填充 形式 ， 所 以 第 1 个 按钮 的 宽 横 
向 填充 屏幕 ， 剩 余 的 两 个 则 超出 屏幕 导致 无 法 看 到 。 一 开始 就 说 过 了 ，LinearLayonut 布局 就 
是 将 组 件 从 左 往 右 放置 ， 而 图 3-2 能 显示 全 部 的 3 个 按钮 组 件 ， 是 因为 将 LinearLayout 的 显 
示 组 件 的 方向 设置 成 了 垂直 放置 。 

为 了 让 大 家 看 的 更 清楚 ， 下 面 将 定义 的 3 个 Button 组 件 的 宽 属性 改 成 自 适应 内 容 的 形 
式 ， 然 后 查看 运行 效果 ， 如 图 3-4 所 示 。 


3-4 ”线性 布局 方式 -组 件 宽度 自 适应 


设置 了 每 个 按钮 的 宽 之 后 ， 可 以 在 屏幕 中 完整 的 看 到 3 个 按钮 组 件 ， 这 也 证 实 了 图 3-3 
中 只 显示 一 个 按钮 的 原因 。 
下 面 在 LinearLayout 里 继续 嵌 套 一 个 LinearLayout 布局 ， 然 后 修改 main.xml 如 下 : 


<?xrml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="fill parent™" 
android:layout height="fill parent" 
> 
<Button 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Buttonil" 
/> 
<LinearLayout android:orientation="vertical" 
android:layout width="fill parent" 
android:1layout height="fill parent" 
> 
<Button 
android:layout width="wrap content™" 
android:layout height="wrap content" 
android:text="Button2" 
/> 
<Button 
android:1layout width="wrap content" 
android:layout height="wrap content" 
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android:text="Button3" 
/> 
</LinearLayout> 
</LinearLayout> 


修改 后 的 布局 文件 将 Button2 与 Button3 放 在 了 嵌 套 的 LinearLayout 当中 ， 并 且 获 套 的 
LinearLayout 属性 与 最 外 层 的 LinearLayout 宽 高 属性 定义 一 样 ， 只 是 嵌 套 的 布局 将 控件 显示 
方向 设置 成 了 午 直 方向 ， 那 么 来 看 运行 的 效果 〈 如 图 3-5 所 示 ) : 


Btutton1 四 Btutton2 


3-5 ”线性 布局 方式 - 嵌 套 布局 


在 图 3-5 所 示 的 界面 中 ， 可 以 看 到 Button2 与 Button3 徘 直 放 置 ， 这 是 因为 嵌 套 的 线性 布 
局 的 影响 ， 而 Buttonl 与 Button2、Button3 仍然 是 以 水 平方 式 排列 ， 这 是 因为 最 外 层 的 线性 
布局 的 影响 。 

下 面 来 介绍 一 个 重要 的 属性 “Layout_ weight”。 所 有 的 组 件 都 有 Layout_weight 属性 ， 

不 设置 的 情况 下 ， 默 认为 零 。 其 属性 表示 当前 还 有 多 大 视图 就 占据 多 大 的 视图 : 如 果 其 值 高 
于 零 ， 则 表示 将 父 视图 中 可 用 的 空间 进行 分 割 ， 分 割 的 大 小 视 当 前 屏幕 整体 布局 的 
Layout_weight 值 与 每 个 组 件 Layout_weight 值 的 占用 比例 而 定 。 

修改 布局 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android™" 
android:orientation="horizontal" 
android:layout width="fill parent™" 
android:layout height="fill parent" 
> 
<Button 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Buttonil" 
y= 
<LinearLayout android:orientation="vertical" 
android:layout width="fill parent" 
android:layout height="fill parent" 
> 
<Button 
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android: 
android: 
android: 
android: 


/> 
<Button 


android: 
android: 
android: 
android: 


/> 
</LinearLayout> 


</LinearLayout> 


layout width="wrap content" 
layout height="wrap content" 
text="Button2" 

layout weight="1" 


layout width="wrap content" 
layout height="wrap Content" 
text="Button3" 

layout weight="1" 


在 Button2 与 Button3 组 件 里 多 定义 了 android:layout_weight 属性 ， 然 后 看 一 下 运行 后 的 
效果 ， 如 图 3-6 所 示 。 


怠 硬 曙 6:17PM 


Btutton2 


Btutton3 


图 3-6 ”线性 布局 方式 -layout_weight 属性 


因为 Button2 与 Button3 添加 了 android:layout_weight 属性 ， 而 且 其 值 为 1， 大 于 零 了 ， 


所 以 将 藤 套 Button2 与 Button3 的 LinearLayout 布局 剩余 空间 全 部 占据 。 又 因为 Button2 与 
Button3 的 android:layout_weight 属性 值 都 是 1， 所 以 空间 被 两 者 平分 占据 ; 而 横向 没有 占据 


的 原因 


是 因为 嵌 套 Button2 与 Button3 的 LinearLayout 布局 ， 设 置 了 显示 组 件 方 式 为 冬 直 显 


示 ， 所 以 Button2 与 Button3 的 父 视图 剩余 空间 只 有 纵向 空间 。 
线性 布局 中 常用 的 属性 还 有 3 种 : 
(1) gravity : 每 个 组 件 默认 其 值 为 左上 角 对 齐 ， 其 属性 可 以 调整 组 件 对 章 方式 比如 向 


左 、 
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(2) padding: 边 距 的 填充 ， 也 称 内 边 距 。 其 边 距 属性 有 : 
android:paddingTop， 设 置 上 边 距 ; 
android:padding Bottom， 设 置 下 边 距 ; 
android:paddingLeft， 设 置 左边 距 ; 
android:paddingRight， 设 置 右边 距 ; 
android:padding 则 表示 周围 四 方向 各 内 边 距 统一 调整 。 

边 距 属性 值 为 具体 数字 。 

(3) layout_margin: 外 边 距 ， 其 上 下 左右 属性 为 : 
android:layout_ marginTop， 设 置 上 边 距 ; 
android:layout_marginBottom， 设 置 下 边 距 ; 
android:layout_marginLeft， 设 置 左边 距 ; 
android:layout_marginRight， 设 置 右边 距 ; 
android:layout_margin 则 表示 设置 四 方向 边 距 统一 调整 。 
padding 与 layout_margin 的 区 别 如 图 3-7 所 示 。 


padding 


组 件 1 


layout_margin 


组 件 2 


padding 


图 3-7 两 种 边 距 的 区 别 


padding 内 边 距 指 的 是 当前 布局 与 包含 的 组 件 之 间 的 边 距 ; 
layout_margin 外 边 距 指 的 是 与 其 他 组 件 之 间 的 边 距 。 


3.2.2 ”相对 布局 


RelativeLayout (相对 布局 ) : 除了 最 常用 的 LinearLayout 之 外 ， 相 对 布局 则 是 另外 一 种 
常用 的 布局 。 与 线性 布局 不 同 之 处 在 于 ， 线 性 布局 如 果 需 要 将 一 组 件 对 齐 另 一 个 组 件 就 必须 
将 所 有 的 组 件 进行 对 齐 ， 或 者 使 用 凡 套 布局 才 可 完成 : 但 是 相对 布局 不 必 这 么 麻烦 。 因 为 在 
相对 布局 中 ， 每 个 组 件 都 可 以 指定 相对 于 其 它 组 件 或 父 组 件 的 位 置 ， 只 是 必须 通过 ID 来 进 
行 指定 。 修 改 main.xml 布局 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
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android:layout width="fill parent™" 
android:layout height="fill parent" 
> 
<Button 
android:layout width="wrap content" 
android:1layout height="wrap content" 
android:text="Buttonl" 
android:id="@+id/btni1" 
/> 
<Button 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="Button2" 
android:id="@+id/btn2" 
android:layout below="@id/btn1l" 
/> 
<Button 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Button3" 
android:id="@+id/btn3" 
android:layout below="@id/btn2" 
android:layout alignRight="@id/btn2" 
3 
<Button 
android:layout width="wrap content™" 
android:1layout height="wrap content" 
android:text="Button4" 
android:id="@+id/btn4" 
android:layout below="@id/btn3" 
android:layout alignParentRight="true”" 
/> 
<Button 
android:layout width="wrap content™" 
android:layout height="wrap content" 
android:text="Button5" 
android:id="@+id/btn5" 
android:layout below="@id/btn4" 
android:layout centerHorizontal="true”" 
> 
</RelativeLayout> 


先 来 看 运行 的 效果 ， 如 图 3-8 所 示 。 


58 


第 3 章 。” Android 游戏 开发 常用 的 系统 控件 


态 阐 入 4:40AM 


3-8 相对 布局 


在 布局 文件 中 使 用 相对 布局 并 定义 了 5 个 Button， 下 面 对 每 个 Button 属性 的 设置 进行 详 
细 讲 解 。 

QDButton1: 设置 了 宽 、 高 、ID 和 按钮 文本 。 

@Button2: 设置 了 组 件 之 间 位 置 关系 的 属性 。 

android:layout_below="@id/btn1" 表示 该 组 件 位 置 放 在 ID 为 btnl 组 件 的 下 方 ， 除 此 之 外 
组 件 之 间 的 位 置 关系 还 有 3 个 属性 ， 详 细 如 表 3-1 所 示 〈 属 性 值 为 组 件 ID〉。 


表 3-1 组 件 之 间 的 位 置 关系 


id: layout_above 和 件 放 在 指定 ID 组 件 的 上 方 


id: layout_below 和 件 放 在 指定 ID 组 件 的 下 方 
id: layout_ toLeftOf 将 该 组 件 放 在 指定 ID 组 件 的 左 方 
id: layout toRightOf 将 该 组 件 放 在 指定 ID 组 件 的 右 方 


@Button3: 设置 了 组 件 之 间 对 齐 方式 的 属性 。 

android:layout_alignRight="(@id/btn2" 表 示 Button3 与 ID 为 btn2 的 组 件 进行 右边 缘 对 齐 ; 
其 他 几 种 对 齐 方式 如 表 3-2 所 示 〈 属 性 值 为 组 件 ID〉。 

@Button4: 设置 了 组 件 与 父 组 件 之 间 的 对 齐 方式 的 属性 。 

android:layout_alignParentRight="true" 表 示 当 前 组 件 与 父 组 件 进行 右边 缘 对 齐 ; 其 他 几 种 
与 父 组 件 对 齐 方式 如 表 3-3 所 示 〈 属 性 值 只 有 true 和 false， 默 认为 false) 。 
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表 3-2 组 件 对 齐 方式 
作用 
id: layout alignBaseline 将 该 组 件 放 在 指定 ID 组 件 进行 中 心 线 对 齐 
id: layout_ alignTop 将 该 组 件 放 在 指定 ID 组 件 进行 顶部 对 齐 


id: layout alignBottom 将 该 组 件 放 在 指定 ID 组 件 进行 底部 对 齐 
id: layout alignLeft 将 该 组 件 放 在 指定 ID 组 件 进行 左边 缘 对 齐 


表 3-3 ”当前 组 件 与 父 组 件 的 对 齐 方式 


属性 名 称 作用 
android: layout_alignParentTop 该 组 件 与 父 组 件 进行 顶部 对 齐 


@@Button5: 设 置 了 组 件 方向 的 属性 。 
android:layout_centerHorizontal ="true" 表 示 该 组 件 放 置 在 水 平方 向 的 中 央 位 置 ， 其 他 方向 
的 属性 如 表 3-4 所 示 (属性 值 只 有 true 和 false， 默 认为 false) 。 
表 3-4 组件 放置 的 位 置 


在 相对 布局 中 ， 设 置 一 个 组 件 的 位 置 ， 一 般 要 有 “上 下 ”与 “左右 ”两 个 位 置 属性 来 进 
行 固定 ， 当 然 有 时 用 一 个 也 是 对 的 。 但 是 设置 一 种 就 可 固定 其 组 件 位 置 的 原因 在 于 Android 
在 排版 组 件 的 时 候 ， 如 不 设置 位 置 等 属性 ， 默 认 仍 在 屏幕 最 上 角 ， 也 就 是 说 使 用 一 个 位 置 属 
性 能 正常 固定 组 件 所 放 的 位 置 ， 是 因为 系统 默认 有 一 个 “最 左 ” 和 “最 上 ”的 隐藏 位 置 属 
性 。 

例如 : 有 3 个 按钮 button1、button 2、button 3， 布 局 定义 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android™ 
android:orientation="vertical" 
android:layout width="fill parent™ 
android:layout height="fill parent" 
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<Button 
android:text="Button1l" 
android:id="@+id/buttonil™" 
android:layout width="wrap content" 
android:layout height="wrap content"> 
</Button> 

<Button 
android:text="Button2" 
android:id="@+id/button2" 
android:layout toRightof="@id/buttonl" 
android:layout width="wrap content" 
android:layout height="wrap content"> 
</Button> 

<Button 
android:text="Button3" 
android:id="@+id/button3" 
android:layout below="@id/button1l" 
android:layout width="wrap content" 
android:layout height="wrap content"> 
</Button> 

</RelativeLayout> 


在 布局 中 ， 定 义 了 3 个 按钮 组 件 ，Buttonl 默认 放 在 屏幕 最 上 角 ，Button2 放 在 Button1 的 
右 侧 ，Button3 放 在 Buttonl 的 下 方 ， 运 行 效果 如 图 3-9 所 示 。 


咒 而 丘 12:35 PM 
人 3 


Button3 


3-9 三 个 按钮 的 布局 
不 再 修改 这 3 个 按钮 的 属性 ， 然 后 添加 一 个 Button4， 其 Button4 在 布局 中 的 定义 如 下 : 


<Button 
android:text="Button4" 
android:layout toRightof="@id/button3" 
android:layout width="wrap content" 
android:layout height="wrap content"> 
</Button> 


很 明显 ， 将 会 认为 Button4 放 在 了 Button3 的 右 侧 ， 那 么 查看 一 下 此 时 的 运行 效果 ， 如 图 
3-10 所 示 。 
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态 天 名 12:38 PM 
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3-10 ”四 个 按钮 的 布局 


但 是 ，Button4 的 位 置 不 是 理想 中 放 在 Button3 的 右 侧 ， 而 是 覆盖 掉 了 Button2。 其 实 也 
不 奇怪 ， 因 为 只 是 设 定 了 Button4 放 在 Button3 的 右 侧 ， 上 下 位 置 并 没有 设置 ， 并 且 Button2 
也 在 Button3 的 右 侧 ， 所 以 Button4 被 放置 在 了 和 Button2 一 样 的 位 置 上 ， 这 也 证 实 了 一 个 位 
置 属性 是 无 法 固定 组 件 的 。 

那么 为 什么 Button2，Button3 也 是 一 个 位 置 属性 ， 就 可 以 正常 显示 呢 ? 

Button2 能 正常 放 在 Buttonl 的 右 侧 ， 那 是 因为 Button2 的 上 方 没有 组 件 存在 ， 如 果 还 有 
组 件 存在 ， 那 么 Button2 的 上 下 位 置 肯定 也 是 错 的 ! 这 证 实 了 隐藏 属性 “最 上 ”。 

Button3 能 正常 显示 在 Button1 下 方 也 是 因为 Button3 的 左 侧 没有 其 他 组 件 存在 ， 如 果 其 
左 侧 还 有 组 件 ， 那 么 Button3 的 位 置 也 肯定 是 错 的 ! 这 证 实 了 隐藏 属性 “最 左 ”。 

所 以 在 相对 布局 中 ， 如 果 像 固定 一 个 组 件 的 位 置 ， 至 少 要 确定 组 件 “左右 ”与 “上 下 ? 
两 个 位 置 才 可 准确 固定 组 件 位 置 。 


3.2.3 ”表格 布局 


TableLayout (表格 布局 ) 的 样式 如 同一 个 表格 。 通 常情 况 下 ，TableLayout 有 多 个 
TableRow 组 成 ， 每 个 TableRow 就 是 一 行 ， 定 义 几 个 TableRow 就 是 定义 几 行 ，TableLayout 
不 会 显示 行列 号 ， 也 没有 分 割 线 。 其 行 数 和 列 数 也 是 由 自己 来 操作 和 确定 的 。 

下 面 先 看 一 个 简单 的 表格 布局 的 效果 ， 如 图 3-11 所 示 。 


支 面 量 10:27 AM 


站 图 
Bue 


图 3-11 表格 布局 


再 来 看 main.xml 中 如 何 实 现 的 : 


<?xml version="1.0" encoding="utf-8"?> 
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<TableLayout xmlns:android="http:/V/schemas.anadroiad.com/apk/res/anadroia" 
android:layout width="fill Parent" 
android:layout height="fill parent" 
> 
<TableRow> 
<Button android:text="Buttonl" /> 
<Button android:text="Button2" /> 
<Button android:text="Button3"/> 
</TableRow> 
<TableRow> 
<Button android:text="Button4" /> 
<Button android:text="Button5" /> 
<Button android:text="Button6" /> 
</TableRow> 
<TableRow> 
<Button android:text="Button7" /> 
<Button android:text="Button8" /> 
<Button android:text="Button9" /> 
</TableRow> 
</TableLayout> 


布局 文件 很 简单 ， 在 表格 布局 中 定义 了 3 行 ， 每 一 行 中 有 3 个 Button 组 件 。 

下 面 来 介绍 在 TableLayout 中 常 使 用 的 几 个 属性 : 

(1) shrinkColumns 属性 : 以 0 为 序 ， 当 TableRow 里 面 的 控件 布 满 布局 时 ， 指 定 列 自动 
延伸 以 填充 可 用 部 分 ， 当 TableRow 里 面 的 控件 还 没有 布 满 布局 时 ，shrinkColumns 不 起 作 
用 。 

在 布局 中 添加 shrinkColumns 属性 代码 如 下 : 


<TableLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:shrinkColumns="2" 


添加 设置 表格 布局 的 android:shrinkColumns= "2"， 指 定 第 3 列 填充 可 用 部 分 ， 然 后 运行 
项 目 ， 效 果 如 图 3-12 所 示 。 

虽然 没有 任何 的 改变 ， 但 是 这 也 证 实 了 ， 当 TableRow 里 的 控件 还 没 布 满 布局 的 时 候 ， 
shrinkColumns 属性 不 起 作用 ， 因 为 Button3 右 侧 还 有 不 少 空间 ; 那么 ， 来 加 长 Button3 这 个 
按钮 的 名 称 使 其 填 满 TableRow 布局 ， 运 行 项 目 后 的 效果 如 图 3-13 所 示 。 

不 设置 shrinkColumns 属性 之 前 的 原 效 果 如 图 3-14 所 示 。 通 过 这 两 个 图 的 对 比 ， 就 很 清 
晰 shrinkColumns 的 作用 了 。 
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图 3-12 android:shrinkColumns="2" 的 布局 图 3-13 加 长 Button3 按钮 名 称 的 布局 


总 硬 幼 10:42 AM 
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图 3-14 不 设置 shrinkColumns 属性 之 前 的 原 效 果 


(2) strechColumns 属性 : 以 第 0 行为 序 ， 指 定 列 对 空白 部 分 进行 填充 。 
在 布局 中 添加 strechColumns 属性 代码 如 下 : 


<TableLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:stretchColumns="2" 


人 


添加 设置 表格 布局 的 android:stretchColumns= "2"， 指 定 第 3 列 填充 空白 部 分 ， 然 后 运行 
项 目 ， 效 果 如 图 3-15 所 示 。 


支 而 丘 10:48 AM 


ableLayoutPro 


Button1 Button3 


Button6 
Button9 


3-15 ”设置 android:stretchColumns= "2 "的 布局 
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可 以 明显 看 到 3X3 的 按钮 矩阵 剩余 的 空间 被 第 3 列 自 动 填充 了 。 
(3) collapseColumns 属性 : 以 第 0 行为 序 ， 隐 藏 指定 的 列 。 
在 布局 中 添加 collapseColumns 属性 代码 如 下 : 


<TableLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:collapseColumns="2" 


添加 设置 表格 布局 的 android:collapseColumns="2"， 指 定 第 3 列 隐藏 ， 然 后 运行 项 目 ， 
效果 如 图 3-16 所 示 。 


态 天 @ 10:57 AM 


[am | Button2 


图 3-16 设置 android:collapseColumns="2" 的 布局 


可 以 明显 看 到 3X3 的 按钮 矩阵 第 3 列 被 隐藏 了 。 

(4) layout_column 属性 : 以 第 0 行为 序 ， 设 置 组 件 显 示 在 指定 列 。 
(5) layout_span 属性 : 以 第 0 行为 序 ， 设 置 组 件 显示 占用 的 列 数 。 
修改 布局 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<TableLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="fill parent™" 
android:layout height="fill parent" 
> 
<TableRow> 
<Button android:text="Buttonl" android:layout span="3"/> 
<Button android:text="Button2" /> 
<Button android:text="Button3" /> 
</TableRow> 
<TableRow> 
<Button android:text="Button4" android:layout column="2" /> 
<Button android:text="Button5" android:layout column="0" /> 
<Button android:text="Button6" /> 
</TableRow> 
<TableRow> 
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<Button android:text="Button7" /> 

<Button android:text="Button8" /> 

<Button android:text="Button9" /> 
</TableRow> 
</TableLayout> 


Button1 设置 显示 占用 3 个 列 数 大 小 的 空间 ， Button4 设置 显示 在 第 3 列 ，Button2 设置 显 
示 在 第 4 列 。 运 行 项 目 ， 然 后 查看 运行 效果 ， 如 图 3-17 所 示 。 


态 畴 @ 11:21AM 
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3-17 设置 android:layout_ span="3" 的 布局 


从 上 面 效果 图 中 可 以 看 到 ，Button1 确实 占用 了 3 个 列 数 大 小 的 空间 ，Button4 也 通过 设 
置 正常 显示 在 了 第 3 列 ， 但 是 Button5 没有 按照 设 定 的 显示 在 第 1 列 ， 原 因 在 于 在 表格 布局 
中 ，TableRow 一 行 里 的 组 件 都 会 自动 放 在 前 一 组 件 的 右 侧 ， 依 次 排列 。 所 以 只 要 TableRow 
行 中 第 一 个 组 件 确定 了 所 在 列 ， 其 后 者 就 无 法 再 次 进行 位 置 设 定 ; 其 实 当 Button4 的 设置 起 
了 作用 ， 同 时 也 已 经 影响 到 了 Button5 和 Button6 的 位 置 。 


3.2.4 ”绝对 布局 


AbsoluteLayout (绝对 布局 ) 布局 用 法 如 其 名 ， 组 件 的 位 置 可 以 准确 的 指定 其 在 屏幕 的 
x/y 坐标 位 置 。 虽 然 可 以 精确 的 去 规定 坐标 ， 但 是 由 于 代码 的 书写 过 于 刚 硬 ， 使 得 在 不 同 的 设 
备 ， 不 同 分 辩 率 的 手机 移动 设备 上 不 能 很 好 的 显示 应 有 的 效果 ， 所 以 此 布局 不 推荐 使 用 。 
修改 布局 文件 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<AbsoluteLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical”" 
android:layout width="fill parent" 
android:layout height="fill parent" 
2 
<Button 
android:layout width="wrap content" 
android:layout height="fill parent" 
android:text="Buttonl" 
/> 
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<Button 


android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="Button2" 
/> 

</AbsoluteLayout> 


布局 使 用 绝对 布局 ， 并 且 定 义 2 个 Button 组 件 ， 运 行 项 目 查看 效果 ， 如 图 3-18 所 示 。 


态 因 但 2:50PM 


Button1 


图 3-18 绝对 布局 


从 上 面 运 行 的 效果 图 中 ， 可 以 看 到 组 件 之 间 没 有 自动 对 齐 、 没 有 间隔 ， 都 默认 放 在 屏幕 
的 最 左上 角 。 如 果 想 改变 组 件 的 位 置 ， 只 能 通过 设置 具体 的 x/y 坐标 ， 利 用 属性 layout_x 与 
layout_y 进行 设置 。 

添加 layout_x 与 layout_y 属性 ， 修 改 布局 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<AbsoluteLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical”" 
android:layout width="fill parent" 
android:layout height="fill parent" 
可 
<Button 
android:layout width="wrap content" 
android:layout height="fill parent" 
android:text="Buttonl" 
android:layout x="100dp" 
> 
<Button 
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android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="Button2" 
android:layout y="100dp" 
ps 

</AbsoluteLayout> 


Buttonl 的 x 坐标 设 定 为 了 100 像素 ，Button2 的 y 坐标 设 定 成 了 100 像素 。 来 看 运行 效 
果 ， 如 图 3-19 所 示 。 


咏 硬 面 2:55pM 


图 3-19 绝对 布局 设置 组 件 位 置 


此 布局 设 定 组 件 位 置 都 使 用 x/y 坐标 来 进行 调整 ， 使 得 整体 布局 格式 代码 很 不 灵活 ， 所 
以 再 次 提醒 大 家 不 到 不 得 已 的 时 候 ， 尽 可 能 不 要 去 沾染 此 布局 。 


3.2.5 “ 单 帧 布局 


FrameLayout 〈 单 帧 布局 ) 是 5 种 布局 中 最 简单 的 一 种 ， 因 为 单 帧 布局 在 新 定义 组 件 的 时 
候 永 远 都 会 将 组 件 放 在 屏幕 的 左上 角 ， 即 使 在 此 布局 中 定义 多 个 组 件 ， 后 一 个 组 件 总 会 将 前 
-个 组 件 所 履 盖 ， 除 非 最 后 一 个 组 件 是 透明 的 。 

修改 布局 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height="fill parent" 
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<Button 
android:layout width="fill Parent" 
android:layout height="wrap content™" 
android:text="Buttonl" 
/> 

<Button 
android:layout width="wrap content" 
android:layout height="fill parent" 
android:text="Button2" 

/> 

<Button 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Button3" 
/> 

</FrameLayout> 


在 单 帧 布局 中 仍 是 定义 了 3 个 按钮 组 件 ， 只 是 每 个 按钮 的 宽 高 属性 不 同 ， 然 后 查看 运行 
效果 ， 如 图 3-20 所 示 。 


Btutton1 


图 3-20 单 帧 布局 


从 图 3-20 中 可 以 看 到 定义 的 3 个 按钮 组 件 都 有 重 登 部 分 ， 单 帧 布局 不 会 像 线性 布局 那样 
每 个 组 件 之 间 自 动 对 齐 并 且 组 件 之 间 都 有 间隔 ， 所 以 在 单 帧 布局 中 定义 3 个 按钮 的 时 候 故意 
将 每 个 按钮 的 组 件 宽 高 设 定 不 同 值 。 如 果 定 义 成 一 样 的 话 ， 就 只 能 在 屏幕 中 看 到 Button3 这 
个 组 件 ， 因 为 其 他 的 2 个 组 件 都 将 会 被 Button3 组 件 所 覆盖 。 
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3.2.6 ”可 视 化 编写 布局 


在 编写 布局 文件 窗口 的 最 左下 方 ， 可 以 看 到 一 个 “Graphical Layout” 页 面 窗口 ， 如 图 3- 
21 所 示 。 


1<7xml version="1.0" encoding="utf-8"?> 
2<AbsoluteLayout xmlns:android= "http://schenas.android.com/apk/res/android" 
3 android:orientation="vertical” 

android:layout_width="fill Parentw 

android:layout_ height="fill parent™" 


<Button 
android: layout_width="yrap_content" 
: android:layout height="fill parent" 
10 android:text="Buttoni" 
1 android: layout_x="100dp" 


pn | ; 


图 3-21 布局 编写 窗口 


单 击 进入 布局 可 视 化 编辑 窗口 ， 如 图 3-22 所 示 。 

左 侧 都 是 一 些 常用 组 件 、 布 局 类 型 等 等 ， 只 要 选中 需要 的 拖 动 到 右 侧 的 模拟 手机 屏幕 的 
窗口 中 ， 按 照 自己 的 意图 去 编 放 位 置 ， 在 main.xml 中 即 可 自动 生成 对 应 的 布局 代码 。 

虽然 可 视 化 很 方便 ， 但 是 建议 大 家 尽 可 能 不 要 去 使 用 ， 因 为 通过 可 视 化 去 实现 的 布局 ， 
即使 能 编 出 自己 满意 的 布局 ， 可 对 其 布局 的 框架 结构 能 了 解 多少 呢 ? 不 出 问题 没什么 区 别 ， 
一 旦 出 现 问 题 ， 找 问题 又 成 了 难点 。 但 是 如 果 布 局 是 用 代码 编写 出 来 的 ， 那 就 明显 会 不 一 
样 。 因 为 使 用 代码 编写 的 过 程 中 ， 布 局 的 整体 结构 和 层次 都 已 经 在 脑海 中 形成 ， 而 且 代码 看 
起 来 也 会 很 清晰 ， 即 便 出 现 问题 ， 找 问题 也 是 很 容易 的 。 除 此 之 外 ， 并 不 是 所 有 的 布局 用 此 
可 视 工 具 都 能 实现 。 
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十 百 


2 mainxml 2 


Editing config: default Anylocale -| Ne Dock |Daytime | |Create.. 


2.7in QVGA ~]ponrak ~] Theme | Android30 ~ 


palette 回国 aaalaa 


Form Widgets 
(上 SSE 


Use other layouts instead. 


EEC 


Layouts 
Composite 
Images & Media 
Time & Date 
Transitions 
Advanced 

国 Graphical Layout (©) mainxml 


图 3-22 布局 可 视 化 编辑 窗口 


所 以 建议 大 家 ， 尤 其 对 于 新 手 而 言 ， 刚 接触 就 一 定 要 多 动手 编写 代码 ， 加 深 对 布局 的 印 
象 和 理解 。 


ImageButton 


ImageButton 与 Button 类 似 ， 区 别 在 于 ImageButton 可 以 自 定义 一 张 图 片 做 为 一 个 按 
钮 :也 正 因为 使 用 图 片 替 代 了 按钮 ， 所 以 ImageButton 按 下 与 抬 起 的 样式 效果 需要 自 定义 。 
下 面 看 看 系统 按钮 组 件 单 击 前 后 的 对 比 图 ， 如 图 3-23 所 示 。 


ee Ti 
re mt Ag 


按钮 
图 未 单 击 状态 掀 单 击 状态 


图 3-23 ”按钮 单 击 前 后 对 比 图 


由 


对 于 ImageButton， 这 里 只 讲解 如 何 实现 按 下 的 状态 切换 ， 由 于 监听 事件 与 Button 无 区 
别 ， 不 再 袭 述 。 
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运行 项 目 ， 效 果 如 图 3-24 所 示 。 


3-24” 自 定义 图 片 按钮 单 击 前 后 对 比 图 


新 建 项 目 “ImageButtonProject” 对 应 的 源 代码 为 “3-3 (ImageButton 图 片 按 钮 )”。 在 
项 目 中 添加 两 张 图 片 资 源 ， 如 图 3-25 所 示 。 


图 3-25 在 项 目 中 添加 两 张 图 片 资 源 


修改 布局 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical”" 
android:layout width="fill parent" 
android:layout height="fill parent" 


> 

<ImageButton 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:id="@+id/imageBtn" 
android:background="@drawable/nopress" 

/> 

</LinearLayout> 


以 上 布局 中 定义 了 一 个 ImageButton， 并 为 其 设 定 了 背景 图 与 ID， 彰 景 图 使 用 未 单 击 的 
图 片 。android:background 属性 表示 为 其 组 件 设置 背景 图 ， 其 属性 值 为 索引 图 片 ID。 

因为 按钮 按 下 和 提起 是 触 屏 事 件 ， 所 以 需 修改 源 代码 去 监听 图 片 按钮 触 屏 事件 ， 在 
ImageButton 按 下 时 设置 改变 背景 图 即 可 ， 修 改 源 代码 如 下 : 
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Public class MainActivity extends Activity { 
private ImageButton Ibtn; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R.layout .main); 
Ibtn = (ImageButton)findViewById (R.id. imageBtn); 
// 为 图 片 按钮 添加 触 屏 监听 
Ibtn.setOnTouchListener (new OnTouchListener() { 
Qoverride 
Public boolean onTouch (View v, MotionEvent event) { 
// 用 户 当前 为 按 下 
if(event .getRction ()==MotionEvent .ACTION DOWN) { 
// 设 置 图 片 按钮 背景 图 


Ibtn.setBackgroundDrawable (getResources () .getDrawablel( 
R.drawable .press)); 
// 用 户 当 前 为 抬 起 
}else if (event.getAction()==MotionEvent.ACTION UP){ 


Ibtn.setBackgroundDrawable (getResources () .getDrawable (R.drawable. 
nopress)); 
} 
return false; 


jo 


为 图 片 按钮 添加 设置 按 下 效果 图 片 的 具体 步骤 如 下 : 


到 王 了》 利用 内 部 类 形式 完成 ImageButton 绑 定 触 屏 监听 ， 这 里 使 用 的 监听 器 为 
OnTouchListener ( 触 屏 监 听 器 ) ， 根 据 此 监听 器 可 以 得 到 屏幕 是 否 被 用 户 按 下 和 抬 起 
等 触 屏 事 件 ， 这 里 使 用 按钮 进行 绑 定 则 表示 用 户 是 否 按 下 按钮 、 按 钮 抬 起 等 事件 。 

重 写 接口 中 的 onTouch ( View v，MotionEvent event ) 抽象 函数 。onTouch ( View 
v，MotionEvent event ) 的 参数 说 明 如 下 : 
@ 第 一 个 参数 : 表示 触发 触 屏 事件 的 事件 源 view; 
® 第 二 个 参数 : 表示 触 屏 事 件 的 类 型 ， 如 按 下 ， 抬 起 ， 移 动 等 。 

2》 利用 MotionEvent,getAction() 函 数 判断 用 户 触发 事件 的 类 型 。 触 发 事件 有 两 种 类 型 

e MotionEvent.ACTION_DOWN: 按 下 事件 ; 
e MotionEvent.ACTION_UP: 抬 起 事件 。 


根据 按 下 与 抬 起 事件 的 不 同 ， 调 用 ImageButton 类 中 的 setBackgroundDrawable() 函 


> 
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数 设 置 ImageButton 背景 图 即 可 。 


getResources().getDrawable(int ID): 传 入 图 片 ID 得 到 一 个 Drawable 对 象 。 有 关 
getResources 在 本 章 3.10.3 小 节 中 有 讲解 ， 不 再 著述 。 

这 里 对 ImageButton 的 按 下 与 抬 起 事件 都 做 了 处 理 ， 其 原因 是 当 用 户 抬 起 按钮 事件 时 能 
让 图 片 按钮 回复 到 没有 点 击 的 状态 图 ， 和 否则 将 一 直 处 于 按 下 按钮 的 状态 图 。 


4 Eoin 


EditText (输入 框 》 是 与 用 户 交互 数据 的 常用 组 件 ， 例 如 在 登录 游戏 ， 输 入 帐号 、 密 码 等 
信息 时 经 常用 到 。 

新 建 项 目 “EditTextProject”， 对 应 的 源 代码 为 “3-4 (EditText 文本 编辑 ) ”。 修 改 项 目 
的 布局 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:orientation="vertical" 

android:layout width="fill Parent" 

android:layout height="fill parent" 

> 

<TextView 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="@string/hello" 
android:id="@+id/tv" 
/> 
<EditText 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:hint=" 翅 示 诬 筷 " 
android:id="@+id/et" 
光 
<Button 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text=" 获 殉 EaitText 内 谷 !" 
android:id="@+id/btn™ 
/> 
</LinearLayout> 


这 里 讲 下 EditText 中 的 android:hint 属性 。hint 是 指 输入 框 中 没有 任何 内 容 的 情况 下 ， 默 
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认 出 现 的 提示 信息 ; 一 旦 输入 框 有 内 容 ， 那 么 hint 提示 信息 将 被 内 容 蔡 代 。 
运行 效果 如 图 3-26 所 示 。 


EditTextProject 


获取 EditText 内 容 ! 


3-26 ”EditTextProject 项 目 运 行 效果 图 


EditText 中 的 “提示 信息 ”为 hint 属性 的 提示 内 容 ， 而 不 是 EditText 的 文本 内 容 ， 所 以 
EditText 中 不 输入 内 容 时 ， 即 使 单 击 按钮 获取 EditText 文本 内 容 ， 也 不 会 获取 到 “提示 信 
息 ” 字 样 。 

EditText 组 件 最 重要 的 就 是 获取 用 户 输入 的 内 容 ， 下 面 来 做 一 个 “ 单 击 按钮 获取 用 户 在 
EditText 中 输入 的 内 容 ” 的 项 目 ， 修 改 源 代 码 MainActivityjava 如下: 


Public class MainActivity extends Activity implements OnClickListener{ 
Private EditText et;// 创 建 一 个 文本 编辑 的 对 象 
Private Button btn; 
Private TextView tv; 
Q@Override 
Public void onCreate(Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R.layout .main); 
et= (EditText)findViewById(R.id.et);// 实 例 化 文本 编辑 
btn= (Button) findViewById(R.id.btn); 
btn.setOonClickListener (this); 
tv = (TextView)findViewById(R.id. tv); 
Q@Override 
Public void onClick(View v) { 
if (v==btn){ 
// 获 取 EditText 中 的 文本 内 容 
String str = et.getText().tostring(); 
// 让 TextView 将 获取 到 的 EditText 内 容 str 显示 出 来 
tv.setText (str); 


在 EditText 中 输入 “himi”， 然 后 单 击 按 钮 ， 效 果 如 图 3-27 所 示 。 
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EditTextProject 


获取 EditText 内 容 ! 


图 3-27 EditText 一 单 击 按钮 效果 图 


在 没有 单 击 按钮 之 前 ，EditText 中 显示 的 为 “提示 信息 ”; 当 输 入 内 容 的 时 候 ， 提 示 信 
息 消失 ， 单 击 按钮 之 后 ，TextView 中 显示 了 EditText 中 的 内 容 “himi”。 
有 些 时 候 用 户 可 能 会 通过 EditText 输入 密码 ， 这 时 为 了 保护 用 户 隐 私 ， 当 用 户 在 
EditText 中 输入 内 容 的 时 候 ， 其 内 容 都 会 被 “* ”符号 所 替代 ; 其实 这 个 功能 也 是 EditText 的 
-种 属性 ， 只 需要 在 布局 中 定义 EditText 时 设置 其 属性 即 可 。 
在 布局 中 添加 EditText 密码 输入 属性 ，android:password， 设 置 其 值 为 true (其 默认 值 为 
false) ， 然 后 重新 运行 项 目 ， 输 入 内 容 ， 效 果 如 图 3-28 所 示 。 


EditTextProject 


图 3-28 EditText 内 容 输 入 为 密码 形式 


EditText 其 他 常用 属性 : 


全 


android:numeric="integer"， 表 示 只 能 在 EditText 中 输入 数字 ; 
android:singleLine="true"， 表 示 在 EditText 中 输入 的 内 容 单行 显示 ， 不 自动 换行 ; 
android:maxLength="1"， 表 示 设 置 EditText 输入 内 容 最 大 长 度 为 1。 


CheckBox 


打开 项 目 “CheckBoxProject”， 对 应 的 源 代 码 为 “3-5 (CheckBox 与 监听 ) ”， 在 布局 
中 注册 CheckBox 组 件 ， 代 码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical”" 
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android:layout width="fill parent" 
android:layout height="fill parent" 
> 
<TextView 
android:layout width="fill parent" 
android:1layout height="wrap content" 
android:text="CheckBoxProject" 
Ve 
<CheckBox 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="CheckBox1" 
android:id="@+tid/cbl" 
/> 
<CheckBox 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="CheckBox2" 
android:id="@+id/cb2" 
We 
<CheckBox 
android:layout width="fill parent™" 
android:layout height="wrap content" 
android:text="CheckBox3" 
android:id="@+id/cb3" 
/> 
</LinearLayout> 


定义 3 个 CheckBox， 然 后 修改 源 代码 MainActivity 对 3 个 CheckBox 进行 监听 。 


// 使 用 状态 改变 检查 监听 器 
public class MainActivity extends Activity 
implements OnCheckedChangeListener{ 
Private CheckBox cbl，cb2，cb3;// 创 建 3 个 CheckBox 对 象 
@Override 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedIinstanceState); 
setContentView(R.layout.main); 
// 实 例 化 3 个 CheckBox 
cbl = (CheckBox) findViewById(R.id.cbl); 
cb2 = (CheckBox) findViewById (R.id.cb2); 
cb3 (CheckBox) findViewById (R.id.cb3) 
cbl.setonCheckedChangeListener (this); 
cb2.setOonCheckedChangeListener (this); 
cb3.setOonCheckedChangeListener (this); 


ll 


// 重 写 监听 器 的 抽象 函数 
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@Override 
public void onCheckedChanged (CompoundButton buttonView, boolean 
isChecked) { 
//buttonView 选中 状态 发 生 改变 的 那个 按钮 
//isCchecked 表示 按钮 新 的 状态 (true/false) 
if(cbl == buttonView||cb2 == buttonView ||cb3 == buttonView) { 
if(isChecked){ 
// 显 示 一 个 提示 信息 
toastDisplay (buttonView.getText () + "选中 ") ; 


}elsei{ 
toastDisplay (buttonView.getText() + "取消 选中 ") ， 
下 
1 
} 
public void toastDisplay (String str){ 
Toast.makeText (this, str, Toast.LENGTH SHORT).show(); 
} 


对 CheckBox 进行 监听 ， 步 又 如 下 : 


使 用 OnCheckedChangeListener 接口 ， 这 里 的 接口 导入 的 是 : 


“android.widget.CompoundButton.OnCheckedChangeListener” ; 
而 不 是 “android.widget.RadioGroup.OnCheckedChangeListener”。 
RadioGroup 下 的 OnCheckedChangeListener 接口 是 对 RadioButton 按钮 进行 监听 的 接口 。 
这 里 千 万 不 要 使 用 错 了 接口 ， 关 于 RadioButton 后 文 将 详细 讲解 。 


仍 强 3》 重 写 监听 器 的 抽象 函数 “onCheckedChanged()”。 
他 测 弄 》 将 每 个 CheckBox 组 件 绑 定 监听 器 。 


通过 重 写 的 onCheckedChanged (CompoundButton buttonView，boolean isChecked) 函数 第 
-个 参数 来 确定 哪个 CheckBox 状态 发 生 改变 ， 根 据 第 二 个 参数 来 确定 改变 的 CheckBox 的 具 

体 状 态 值 ，true 为 勾 选 ，false 为 未 勾 选 。 

MainActivity 类 中 还 定义 了 toastDisplay() 函 数 ， 其 实 只 是 为 了 使 用 Android 的 一 种 提示 信 
息 的 方式 ;Toast: 主要 用 于 提示 信息 ， 使 用 起 来 很 方便 ， 先 创建 Toast 对 象 ， 然 后 调用 
makeText() 方 法 得 到 一 个 Toast 实例 对 象 。 

M makeText (Context context, CharSequence text, int duration) 

第 一 个 参数 是 上 下 文 对 象 ， 第 二 个 参数 显示 的 文本 内 容 ; 第 三 个 参数 显示 提示 消息 的 持续 
时 间 ; 其 值 有 两 个 常量 : LENGTH_SHORT (短暂 持续 ) 和 LENGTH_ LONG ( 略 长 持续 ) 。 

最 后 ， 使 用 Toast 对 象 调 用 show() 方 法 即 可 。 
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如 果 想 让 Toast 提示 在 一 个 特定 的 条 件 下 立即 消失 ， 那 么 首先 应 该 定义 一 个 Toast 成 员 


变量 ， 然 后 通过 makeText 函数 获取 其 实例 赋值 与 定义 的 Toast 成 员 变量 ， 这 样 一 来 如 果 想 
让 提示 立刻 消失 ， 直 接 让 定义 的 Toast 成 员 变 量 设置 为 null 即 可 。 


“CheckBoxProject” 项 目 运行 结果 如 图 3-29 所 示 。 


国 checson 
图- 


图 -eceoas 


Toast 提 示 信 息 


图 3-29 ”CheckBoxProject 项 目 运行 效果 图 


RadioButton 


RadioButton 是 单 选 按 钮 ， 而 上 面 介绍 的 CheckBox 是 复 选 框 。RadioButton 一 般 都 存在 单 
选 组 (RadioGroup) 中 ， 当 多 个 RadioButton 存放 在 同一 个 单 选 组 (RadioGroup)〉 中 ， 只 能 单 
选 一 个 RadioButton; 如 果 想 实现 RadioButton 的 多 选 ， 那 就 需要 多 个 RadioGroup 。 

新 建 项 目 “RadioButtonProject”， 对 应 的 源 代码 为 “3-6 (RadioButton 与 监听 ) ”。 

“RadioButtonProject” 项 目 运 行 效果 如 图 3-30 所 示 。 
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11:36 AM 


F 
(@) RadioButton1 
【©) RadioButton2 
(@) RadioButton3 


选择 了 下 标 为 "RadioButton2" 的 单 选 按钮 


图 3-30 RadioButtonProject 项 目 运行 效果 图 
修改 布局 文件 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:orientation="vertical" 

android:layout width="fill parent" 

android:layout height="fill parent" 

> 

<RadioGroup 

android:id="@+id/radGrp" 
android:layout width="wrap content" 
android:layout height="wrap content"> 
<RadioButton 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="RadioButtoni1" 
J 
<RadioButton 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="RadioButton2" 
We 
<RadioButton 

android:layout width="fill parent" 
android:layout height="wrap content" 
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android:text="RadioButton3" 
* 
</RadioGroup> 
</LinearLayout> 


定义 了 3 个 RadioButton， 而 且 都 定义 在 RadioGroup( 单 选 按 钮 组 ) 中 ， 绑 定 监听 ， 修 
改 源 代码 MainActivity 如 下 : 


// 使 用 状态 改变 监听 器 
Public class MainActivity extends Activity implements 
OnCheckedChangeListener { 

Private RadioButton rbl, rb2, rb3; 

Private RadioGroup rg; 


QOverride 

Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 
rbl = (RadioButton) findViewById(R.id.rb1); 
rb2 (RadioButton) findViewById(R.id.rb2); 
rb3 (RadioButton) findViewById(R.id.rb3); 
rg = (RadioGroup) findViewById(R.id.radGrp); 
rg.setOnCheckedChangeListener (this) ;// 将 单 选 组 绑 定 监听 器 


// 重 写 监听 器 函数 


@Override 
Public void onCheckedChanged (RadioGroup group, int checkedId) { 
if (group==rg) {// 因 为 当前 程序 中 只 有 一 个 RadioGroup， 此 步 可 以 不 进行 判定 
String rbName = null; 
if (checkedId == rbl.getId()) { 
rbName = rbl.getText().toSstring(); 
} else if (checkedId == rb2.getId()) { 
rbName = rb2.getText().toSstring(); 
} else if (checkedId == rb3.getId()) { 
rbName = rb3.getText().toString(); 
Toast.makeText (this, "选择 了 下 标 为 "”+ rbName+"“ 的 单 选 按 钮 "， 
Toast. LENGTH LONG) .show (); 


RadioButton 与 CheckBox 监听 步骤 类 似 ， 但 RadioButton 监听 需要 注意 三 点 : 


e@ RadioButton 与 CheckBox 使 用 的 监听 器 不 同 。 
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e@ RadioButton 绑 定 监听 的 时 候 ， 不 是 每 个 RadioButton 都 去 绑 定 ， 因 为 所 有 的 RadioButton 
都 被 放 在 了 RadioGroup 单 选 组 中 ， 所 以 只 需要 将 RadioGroup 绑 定 上 监听 器 即 可 。 

@ 重 写 监 听 器 函数 onCheckedChanged ( RadioGroup group，int checkedId ) ， 这 个 函数 的 第 
一 个 参数 是 单 选 组， 注意 第 二 个 参数 ， 这 里 的 checkedId 不 是 RadioGroup 单 选 组 中 每 个 
RadioButton 的 下 标 ， 而 是 发 生 状 态 改 变 的 RadioButton 的 内 存 ID! 这 一 点 一 定 要 注 
意 。 所 以 在 进行 判断 哪个 RadioButton 发 生 状 态 改变 的 时 候 ， 可 以 利用 
RadioButton.getID 来 与 checkedId 进行 对 比 。 


ProgressBar 


在 Android 应 用 开发 中 ，ProgressBar (运行 进度 条 ) 是 较 常 用 到 的 组 件 ， 例 如 下 载 进 
度 、 安 装 程序 进度 、 加 载 资 源 进 度 显 示 条 等 。 在 Android 中 提供 了 两 种 样式 来 分 别 表 示 在 不 
同 状态 下 显示 的 进度 条 ， 下 面 来 实现 这 两 种 样式 。 

新 建 项 目 “ProgressBarProject”， 源 代码 为 “3-7 (ProgressBar 进度 条 ) ”， 修 改 布局 文 
件 如 下 ， 运 行 效果 如 图 3-31 所 示 。 


图 3-31 进度 条 运行 效果 图 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android™" 
android:orientation="vertical”" 
android:layout width="fill parent" 
android:layout height="fill parent" 
> 
<TextView 
android:1layout width="wrap content" 
android:layout height="wrap content" 
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android:text=" 锋 以 碎 度 条: " 
/> 
<ProgressBar 
android:1layout width="wrap content" 
android: layout height="wrap content" 
android:text="progress1l" 
/> 
<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android: text=" 小 司 形 六 度 条 : "” 
全 
<ProgressBar 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="progress3" 
style="?android:attr/progressBarStyleSsmall" 
V> 
<TextView 
android:1layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 厌 夺 形 区 度 条 : " 
android:layout gravity="center vertical" 
/> 
<ProgressBar 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="progress3" 
style="?android:attr/progressBarStyleLarge" 
pe 
<TextView 
android:1layout width="wrap content™" 
android:1layout height="wrap content" 
android:text=" 科 形 矿 度 条 : " 
> 
<ProgressBar 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="progress2" 
android:id="@+id/pb" 
style="?android:attr/progressBarSstyleHorizontal" 
android:max="100" 
android:progress="50" 
android: secondaryProgress="70" 
/> 
</LinearLayout> 
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默认 进度 条 是 圆 形 ， 通 过 style 属性 来 指定 系统 进度 条 的 大 小 : 


e@ style="?android:attr/progressBarStyleSmall"， 小 圆 形 进度 条 。 
e@ style="?android:attr/progressBarStyleLarge"， 大 圆 形 进度 条 。 


如 果 需 要 将 进度 显示 为 长 条 形 ， 那 么 style 必须 设 定 为 这 种 类 型 : 
e@ style="?android:attr/ progressBarStyleHorizontal"， 长 条 形 进度 条 。 
针对 长 条 形 进度 条 ， 还 有 几 个 常用 属性 : 


e@ android:max， 设 置 进度 条 最 大 进度 值 。 
@ android:progress， 设 置 进度 条 初始 进度 值 。 
e@ android:secondaryProgress， 设 置 底层 ( 浅 色 ) 进度 值 。 


圆 形 显 示 进 度 条 默认 是 动态 、 但 是 长 条 进度 显示 条 却 是 静态 的 ， 那 么 修改 源 代 码 
MainActivity 实现 长 条 进度 条 为 动态 显示 : 


// 使 用 Runnable 接口 
public class MainActivity extends Activity implements Runnable { 
Private Thread th ; // 声 明 一 条 线程 


Private ProgressBar pb ; // 声 明 一 个 进度 条 对 象 
Private boolean stateChage; // 标 识 进度 值 最 大 最 小 的 状态 
QOverride 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 
// 实 例 进度 条 对 象 
Pb = (ProgressBar) findViewById(R.id.porb); 
th = new Thread (this);// 实 例 线程 对 象 
th.start () ; // 启 动 线程 


@Override 
public void run() {// 实 现 Runnable 接口 抽象 函数 
while(true) { 
int current=pb.getProgress () ;// 得 到 当前 进度 值 
int currentMax=Ppb .getMax () ;// 得 到 进度 条 的 最 大 进度 值 
int secCurrent=pb.getSecondaryProgress () ; // 得 到 底层 当前 进度 值 
// 以 下 代码 实现 进度 值 越 来 越 大 ， 越 来 越 小 的 一 个 动态 效果 
if(stateChage==false){ 
if(current>=currentMax) { 
stateChage=true; 
J}elsel 
// 设 置 进 度 值 


Pb .setProgress (current+1); 
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// 设 置 底层 进度 值 
Pb .setSecondaryProgress (current+1); 
} 
J}elsef{ 
if(current<=0){ 
stateChage=false; 
J}elsel 
pb.setProgress (current-1); 
1 
try { 
Thread. sleep (50); 
} catch (InterruptedException e) { 
// TODO Auto-generated catch block 
e.printSstackTrace (); 


ProgressBar 类 中 常用 函数 如 下 所 示 : 


getProgress(): 获取 当前 进度 值 函数 ; 
setProgress(): 设置 进度 值 函数 ; 
getSecondaryProgress (): 获取 底层 进度 值 函 数 ; 
setSecondaryProgress (): 设置 底层 进度 值 函 数 ; 
getMax(): 获取 当前 最 大 进度 值 函 数 。 


在 线程 循环 中 对 进度 条 的 最 大 进度 值 与 当前 进度 值 进 行 判定 处 理 ， 然 后 不 断 设 置 进度 值 
进而 达到 动态 进度 值 越 来 越 大 ， 或 越 来 越 小 的 动态 效果 。 


3 8 SeekBar 


SeekBar( 拖 动 条 ) 的 外 观 类 似 长 条 进度 条 。Android 手机 上 最 常见 到 拖 动 条 的 地 方 就 是 
在 播放 音乐 的 时 候 ， 当 用 户 在 拖 动 条 上 任意 拖 动 可 以 调整 音乐 播放 的 时 间 段 ; 调整 铃声 音量 
大 小 界面 也 是 利用 的 拖 动 条 与 用 户 进行 交互 。 下 面 来 学 习 如 何 定义 和 监听 拖 动 条 事件 。 

首先 在 布局 文件 中 注册 一 个 拖 动 条 组 件 ， 源 代码 为 “3-8 (SeekBar 拖 动 条 ) ”， 运 行 效 
果 如 图 3-32 所 示 。 
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3-32 ”SeekProject 项 目 运行 效果 图 


新 建 项 目 “SeekProject”， 修 改 布局 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android™" 
android:orientation="vertical" 
android:layout width="fill parent" 
android:layout height="fill parent" 


> 
<TextView 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="SeekBarProject" 
android:id="@+id/tv" 
/> 
<SeekBar 
android:layout width="fill parent™" 
android:layout height="wrap content" 
android:text="SeekBar" 
android:id="@+id/seekbar™" 
/> 
</LinearLayout> 


上 述 代码 简单 声明 了 TextView 和 SeekBar 组 件 ， 下 面 对 拖 动 条 进行 监听 ， 修 改 源 代 码 
MainActivityjava， 修 改 如 下 : 


public class MainActivity extends Activity { 
Private SeekBar seekBar; 
Private TextView tv; 


@Override 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.main); 
seekBar = (SeekBar) findViewById(R.id.seekbar); 
tv = (TextView) findViewById(R.id.tv); 
seekBar.setOnSeekBarChangeListener (new 
OnSeekBarChangeListener() { 
@Override 
public void onStopTrackingTouch (SeekBar seekBar) { 
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tv.setText ("< 拖 动 条 > 完成 拖 动 ") 

Override 

Public void onStartTrackingTouch (SeekBar seekBar) { 
tv.setText ("< 拖 动 条 > 拖 动 中 .. .") 

QOverride 

Public void onProgressChanged (SeekBar seekBar,int 

progress, boolean fromUser) { 

tv.setText ("当前 < 拖 动 条 > 的 值 为 : "+progress); 


DD); 


对 拖 动 条 进行 监听 的 是 setOnSeekBarChangeListener 这 个 接口 ， 这 里 使 用 的 内 部 类 实现 
绑 定 监听 ， 然 后 重 写 接口 的 三 个 函数 : 

。 onStopTrackingTouch: 当 用 户 对 拖 动 条 的 拖 动 动作 完成 时 触发 ; 

® onStartTrackingTouch: 当 用 户 对 拖 动 条 进行 拖 动 时 触发 ; 

e onProgressChanged: 当 拖 动 条 的 值 发 生 改 变 的 时 触发 。 


其 实 拖 动 条 类 似 长 条 提示 进度 条 ， 也 拥有 setMax()、setProgress()、setSecondaryProgress () 
这 些 函数 。 


3 5 9 TabSpec 与 TabHost 


TabHost 相当 于 浏览 器 中 浏览 器 分 页 的 集合 ， 而 Tabspec 则 相当 于 浏览 器 中 的 每 个 分 页 
面 ; 在 Android 中 ， 每 一 个 TabSpec 分 页 可 以 是 一 个 组 件 ， 也 可 以 是 一 个 布局 ， 然 后 将 每 个 
分 页 装 入 TabHost 中 ，TabHost 即 可 将 其 中 的 每 个 分 页 一 并 显示 出 来 。 

本 节 范 例 源 代码 为 “3-9 〈Tab 分 页 式 菜单 ) ”， 运 行 范例 项 目 ， 效 果 如 图 3-33 所 示 。 

打开 项 目 “TabProject”， 在 项 目 资源 中 添加 了 两 张 图 片 资源 bg.png 与 bg2.png ， 如 图 3- 
34 所 示 。 
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Thisis Tab3 


|rhisis Tab3 


4 名 res 
对 drawable-hdpi 
EG drawable-ldpi 
4 EE drawable-mdpi 
看 bg.png 
二 bg2.png 
看 icon.png 
图 3-33 ”分 页 式 布局 图 3-34 项 目 资源 中 添加 了 两 张 图 片 资源 


接 下 来 修改 布局 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical”" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:background="@drawable/bg2" 
> 
<Button 
android:layout width="fill parent" 
android:1layout height="wrap content" 
android:text="This is Tabil" 
android:id="@+id/btn" 
/> 
<EditText 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="This is Tab2" 
android:id="@+id/et" 
/> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/ 
android"™ 
android:orientation="vertical”" 


88 


第 3 章 。” Android 游戏 开发 常用 的 系统 控件 


android:layout width="fill parent" 
android:layout height="fill parent" 
android:id="@+id/mylayout" 
android:background="@drawable/bg" 


> 
<Button 
android:1layout width="fill parent" 
android:1layout height="wrap content" 
android:text="This is Tab3" 
/> 
<EditText 
android:layout width="fill parent" 
android:1layout height="wrap content" 
android:text="This is Tab3" 
71> 
</LinearLayout> 
</LinearLayout> 


布局 中 定义 了 按钮 和 编辑 文本 组 件 ， 只 是 有 两 个 组 件 定义 在 了 一 个 嵌 套 的 布局 中 ;每 个 
布局 属性 都 设置 了 background 属性 ， 其 含义 是 为 布局 添加 背景 图 片 ， 利 用 “@drawable” 来 
索引 资源 文件 下 的 图 片 。 

下 面 来 看 MainActivity 中 的 代码 : 


Public class MainActivity extends TabActivity implements 
OnTabChangeListener { 
Private TabSpec tsl,， ts2，ts3;// 声 明 3 个 分 页 
Private TabHost tableHost;// 分 页 菜单 (tab 的 容器 ) 
QOverride 
Public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
tableHost = this.getTabHost () ;// 实 例 (分 页 ) 菜单 
// 利 用 LayoutInflater 将 布局 与 分 页 菜单 一 起 显示 
LayoutInflater.from(this) .inflate (R.layout .main, 
tableHost .getTabContentView()); 
tsl = tableHost.newTabSpec("tabone") ;// 实 例 化 一 个 分 页 
tsl.setIndicator ("Tabl") ;// 设 置 此 分 页 显示 的 标题 
tsl.setContent (R.id.btn) ;// 设 置 此 分 页 的 资源 id 
ts2 = tableHost.newTabSpec("tabTwo") ; 
// 设 置 此 分 页 显示 的 标题 和 图 标 
ts2 .setIndicator ("Tab2", getResources () .getDrawable( 
R.drawable.icon)); 
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ts2.setContent (R.id.et); 
ts3 = tableHost.newTabSpec ("tabThree"); 
ts3.setIndicator ("Tab3"); 
ts3.setContent (R.id.mylayout) ;// 设 置 此 分 页 的 布局 id 
tableHost .addTab (ts1);// 菜 单 中 添加 tsl 分 页 
tableHost .addTab (ts2); 
tableHost .addTab (ts3); 
tableHost .setOnTabChangedListener (this); 
} 
Q@Override 
Public void onTabChanged (String tabId) { 
if (tabId.equals ("tabOone")) { 


Toast.makeText (this, "分 页 1",，Toast .LENGTH LONG) .show () 


} 
if (tabId.equals ("tabTwo")) { 


Toast.makeText(this，" 分 页 2"，Toast .LENGTH LONG) .show (); 


} 
if (tabId.equals ("tabThree")) { 


Toast.makeText (this,， "分 页 3"，Toast .LENGTH LONG) .show(); 


显示 分 页 式 布局 ， 详 细 步 又 如 下 : 


(1) 继承 TabActivity: 在 此 之 前 继承 的 都 是 android.app.Activity 类 ， 但 是 这 里 需要 继承 


android.app.TabActivity 。 
(2) 创建 TabHost 分 页 菜单 对 象 ， 利 用 以 下 代码 。 


LayoutInflater.from(this) .inflate(R.layout.main, 
tableHost.getTabContentView()); 


将 main.xml 布局 与 tabHost 一 并 显示 在 屏幕 中 ; 有 关 LayoutInflater 类 在 后 续 文章 中 有 详 


细 讲 解 。 
(3) 实例 声明 了 3 个 TabSpec 分 页 对 象 ， 然 后 添加 到 TabHost 中 ; 这 是 
tsl,ts2,ts3 都 设置 了 标题 与 资源 ID 。 


对 每 一 个 分 页 


TabSpec 类 的 setIndicator (CharSequence arg0) 函数 ， 第 一 个 参数 表示 设置 分 页 标题 ,第 


二 个 参数 表示 设置 分 页 的 图 标 。 


TabSpec 类 的 setContent (int arg0) 函数 ， 传 入 的 可 以 是 组 件 ID， 也 可 以 是 布局 ID; 分 
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页 ts1 与 ts2 设置 的 是 组 件 ， 而 ts3 设置 的 则 是 布局 ， 要 注意 的 是 这 里 不 管 传 入 的 是 组 件 ID 还 
是 布局 ID， 都 应 该 是 main.xml 布局 中 的 ID; 因为 在 利用 LayoutInflater 显示 布局 与 分 页 菜单 
时 ， 这 里 的 参数 已 经 指定 main.xml 的 布局 ID 了 。 

从 图 3-33 可 以 看 到 第 二 个 分 页 带 有 图 标 ， 其 实 就 是 源 代码 中 的 ts2 分 页 ， 因 为 ts2 分 页 
使 用 的 是 两 个 参数 的 setIndicator 函数 ， 不 仅 设置 了 标题 还 设置 了 图 标 。 

最 后 利用 TabHost 类 中 的 addTabO 函 数 将 分 页 添加 进去 〈 往 TabHost 添加 的 先后 顺序 就 
是 在 屏幕 中 从 左 往 右 的 页 面 顺序 ) 。 

下 面 来 监听 分 页 改变 事件 ， 具 体 步 又 如 下 : 
龟 沸 对 使 用 OnTabChangedListener 接口 ， 重 写 OnTabChanged ( String tabld ) 函数 。 
TabHost 绑 定 监听 器 。 


判断 OnTabChanged ( String tabId ) 中 的 tabld 参数 进行 处 理事 件 ， 这 里 的 tabId 对 
应 的 是 实例 中 每 个 分 页 传 入 的 分 页 ID， 而 不 是 TabSpec.setIndicator() 设 置 的 标题 。 


3 ] 0 ListView 


ListView (列表 视图 ) 是 一 个 常用 的 组 件 ， 其 数据 内 容 以 列表 形式 直观 的 展示 出 来 ， 比 
如 做 一 个 游戏 的 排行 榜 ， 对 话 列表 等 等 都 可 以 使 用 列表 来 实现 ， 且 ListView 的 优点 是 列表 中 
的 数据 可 以 自 适应 屏幕 大 小 。 

首先 介绍 “适配器 ”这 个 基础 概念 。 在 列表 中 定义 的 数据 都 通过 “适配器 ”来 映射 到 
ListView 上 ，ListView 中 常用 的 适配器 有 两 种 : 


。 ArrayAdapter: 最 简单 的 适配器 ， 只 能 显示 一 行文 字 ; 
e SimpleAdapter: 具有 很 好 扩展 性 的 适配器 ， 可 以 显示 自 定义 内 容 。 


3.10.1 ListView 使 用 ArrayAdapter 适配器 


使 用 ArrayAdapter 适配器 的 范例 源 代码 为 “3-10-1 (列表 之 ArrayAdapter 适 配 ) ”。 打 
开 项 目 “ListViewProject_1”， 修 改 源 代码 MainActivity: 


public class MainActivity extends Activity { 
private ListView lv ;// 声 明 一 个 列表 
private List<String> 1ist ;// 声 明 一 个 List 容器 
Private ArrayAdapter<String> aa ; 
@Override 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
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setContentView(R.layout.main); 

lv = new ListView(this);// 实 例 化 列表 

list = new ArrayList<String>();// 实 例 化 List 

// 往 容器 中 添加 数据 

list.add("Iteml"); 

list.add("Item2"); 

list.add("Item3"); 

// 实 例 适配器 

// 第 一 个 参数 : Context 

// 第 二 个 参数 : ListView 中 每 一 行 布局 样式 

//android.R.layout .simple list item 1: 系统 中 每 行 只 显示 一 行文 字 布局 

// 第 三 个 参数 : 列表 数据 容器 

aa = new ArrayAdapter<String> (this, 
android.R.layout.simple list item 1,1ist); 

lv.setAdapter (aa);// 将 适配器 数据 映射 ListView 上 

this.setContentView (lv); 


显示 一 个 带 有 数据 的 ListView 的 步骤 如 下 : 


三 了》 实例 一 个 添加 数据 的 容器 ， 并 将 数据 放 入 容器 。 
胡 到 2 实例 列表 适配器 ， 并 且 实 例 适 配器 时 将 数据 传 入 。 
人 玫瑰 ”实例 一 个 ListView， 并 且 为 其 设置 适配器 。 

gy 王 区 ”利用 setContentView() 函 数 显 示 ListView。 


运行 范例 项 目 ， 效 果 如 图 3-35 所 示 。 
在 项 目 中 ， 需 要 为 列表 添加 单 击 事件 监听 。 让 一 个 列表 绑 定单 击 事件 监听 ， 只 需要 将 
ListView 设置 监听 器 即 可 ， 添 加 监听 事件 代码 如 下 : 


lv.setOnItemClickListener (new OnItemClickListener() { 
QOverride 
public void onItemClick(AdapterView<?> arg0, View argl, 
int arg2, long arg3) { 
Toast.makeText (MainActivity .this, "当前 选中 列表 项 的 下 标 为 : 
"+arg2, Toast.LENGTH SHORT) .show(); 
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3-35 ListView (ArrayAdapter) 


因为 列表 中 每 一 项 数据 都 是 一 个 Item， 所 以 将 ListView 绑 定 使 用 OnItemClickListener 项 
单 击 监听 器 ， 并 且 重 写 监听 器 中 的 onItemClick() 函 数 。onItemClick() 函 数 的 第 一 个 参数 是 触 
发 的 适配器 ， 第 二 个 参数 是 触发 的 视图 ， 第 三 个 参数 是 适配器 中 项 的 位 置 下 标 ， 第 四 个 参数 
listView 项 下 标 。 


3.10.2 ”ListView 使 用 SimpleAdapter 适配器 的 扩展 列表 


使 用 SimpleAdapter 适配器 的 扩展 列表 的 源 代码 为 “3-10-2( 列 表 之 SimpleAdapter 适 
配 ) ”。 
虽然 使 用 ArrayAdapter 适配器 可 以 显示 列表 ， 但 是 列表 的 每 一 项 〈 行 ) 很 单调 ， 因 为 只 
能 显示 一 行文 本 很 局 限 。 那 么 想 自 定义 列表 每 项 、 自 定义 布局 就 要 使 用 SimpleAdapter 适 配 
器 来 进行 ， 以 对 列表 进行 更 好 的 扩展 ， 例 如 实现 如 图 3-36 所 示 的 效果 。 


图 3-36 ListView (SimpleAdapter) 


新 建 项 目 “ListViewProject 1”， 首 先 设 置 ListView 中 每 一 项 的 布局 ， 因 为 要 自 定 义 
ListView 中 的 项 ， 所 以 不 再 使 用 Android 系统 提供 的 布局 。 修 改 main.xml 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
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<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="fill parent™" 
android:layout height="fill parent" 
> 
<ImageView 
android:layout width="wrap Content" 
android:layout height="wrap content" 
android:id="@+id/iv" 
/> 
<LinearLayout 
android:orientation="vertical”" 
android:layout width="wrap content" 
android:1layout height="wrap content" 
> 
<TextView 
android:1layout width="wrap Content" 
android:1layout height="wrap content" 
android:textSize="20sp" 
android:id="@+id/bigtv" 
Ws 
<TextView 
android:layout width="wrap content" 
android:1layout height="wrap content" 
android:textSize="10sp" 
android:id="@+id/smalltv" 
> 
</LinearLayout> 
<Button 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="button" 
android:id="@+tid/btn" 
/> 
<CheckBox 
android:layout width="wrap content" 
android:1layout height="wrap content™" 
android:id="@+id/cb" 
We 
</LinearLayout> 


首先 定义 布局 为 线性 布局 ， 设 置 布局 方向 为 横向 水 平方 式 ， 并 在 布局 中 添加 了 一 个 
ImageView 图 片 组 件 ， 一 个 按钮 组 件 和 一 个 复 选 框 组 件 。 

在 添加 ImageView 组 件 后 还 入 套 了 一 个 线性 布局 ， 且 赃 套 布局 方向 为 垂直 方向 ， 在 嵌 套 
的 线性 布局 中 添加 了 两 个 TextView 组 件 ， 这 两 个 TextView 组 件 设置 的 字体 大 小 不 同 。 
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然后 修改 源 代码 MainActivity: 


public class MainActivity extends Activity { 

Private SimpleAdapter sp;// 声 明 适 配器 对 象 

private ListView 1istView; // 声 明 列表 视图 对 象 

private List<Map<String,Object>> List;// 声 明 列表 容器 

Q@Override 

Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
// 实 例 化 列表 容器 
list = new ArrayList<Map<String,Object>>(); 
listView = new ListView (this) ;// 实 例 化 列表 视图 
// 实 例 一 个 列表 数据 容器 
Map<String, Object> map = new HashMap<String, Object>(); 
// 往 列表 容器 中 添加 数据 
map.put ("iteml imageivew", R.drawable.icon); 
map.put ("iteml bigtv", "BIGTV"); 
map.put ("iteml smalltv", "SMALLTV"); 
// 将 列表 数据 添加 到 列表 容器 中 
list.add (map); 
// 实 例 适 配器 
sp = new SimpleAdapter (this, list,R.layout.main, new String[]{ 

"iteml imageivew","iteml bigtv", "iteml smalltv"}, new 
int[] { R.id.iv,R.id.bigtv, R.id.smalltv}); 

// 为 列表 视图 设置 适配器 (将 数据 映射 到 列表 视图 中 》 
listView.setAdapter (sp); 
// 显 示 列表 视图 
this.setContentView (listView); 


List 相当 于 ListView 中 的 每 一 项 ， 在 使 用 ArrayAdapter 做 ListView 适配器 时 ，List 容器 
中 只 是 简单 添加 了 String 字符 串 类 型 ， 但 是 这 里 需要 在 ListView 的 每 一 项 中 自 定义 组 件 ， 所 
以 这 里 List 声明 不 再 是 List<String>， 而 是 List<Map<String, Object>>。 

List<Map<String, Object>> 可 以 理解 为 在 ListView 的 每 一 项 中 不 再 是 简单 的 一 行 字符 串 ， 
而 是 将 每 一 项 添加 一 个 组 件 容 器 Map， 在 这 个 Map 容器 中 放置 自 定义 的 组 件 。 其 Map 的 put 
(String key, Object value) 在 进行 添加 数据 时 ， 每 一 个 put0) 函 数 都 对 应 自 定义 ListView 项 中 的 

-个 组 件 ， 但 是 这 里 要 注意 按钮 、 复 选 框 等 组 件 是 无 法 数据 映射 的 。map.put (String key, 

Object value) 的 第 一 个 参数 用 于 初始 化 适配器 时 需要 映射 数据 的 对 应 索引 ; 第 二 个 参数 表示 
对 应 自 定义 项 布局 中 的 组 件数 据 。 

代码 中 实例 化 SimpleAdapter 适配器 构造 函数 SimpleAdapter (Context context List data, 
int resource, String[] from, int [] to) 的 第 一 个 参数 是 当前 context 对 象 ， 第 二 个 参数 是 ListView 
各 项 数据 ， 第 三 个 参数 是 ListView 每 一 项 的 布局 ， 第 四 个 参数 是 每 一 项 中 的 数据 映射 索引 数 
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组 ， 第 五 个 参数 是 每 一 项 中 数据 对 应 的 组 件 ID 数组 。 


3.10.3 为 ListView 自 定义 适配器 


前 面 说 过 按钮 和 复 选 框 等 这 些 附带 事件 的 组 件 其 实 是 无 法 将 数据 映射 在 ListView 上 的 ， 
所 以 如 果 需 要 监听 和 响应 按钮 、 复 选 框 等 组 件 的 事件 时 ， 则 需要 继承 BaseAdapter 进行 自 定 
义 适 配器 来 实现 。 下 面 就 来 对 ListView 自 定义 项 布局 中 的 按钮 和 复 选 框 组 件 进行 事件 监听 处 
理 。 

首先 创建 一 个 新 类 “MyAdapterjava”， 使 之 继承 BaseAdapter 类 ， 并 且 重 写 父 类 的 4 个 
抽象 函数 ， 代 码 如 下 : 


public class MyAdapter extends BaseAdapter { 

Public MyAdapter() { 

} 

QOverride 

public int getCount() { 
return 0; 

上 

QOverride 

Public Object getItem(int position) { 
return null; 

上 

Q@Override 

Public long getIitemId(int position) { 
return 0; 

'; 

@Override 

Public View getView (int position, View convertView, ViewGroup parent) 

{ 
return null; 

上 


当 一 个 ListView 显示 之 前 都 会 调用 适配器 中 的 getCount(O) 函 数 来 确定 ListView 中 项 的 长 
度 ， 然 后 根据 此 长 度 再 去 调用 getView0 函 数 绘制 ListView 中 的 每 一 项 。 
其 实 ListView 中 的 适配器 的 作用 就 是 将 ListView 每 一 项 布局 和 组 件 进行 实例 化 ， 并 且 设 
置 组 件 的 数据 ， 所 以 主要 去 修改 getCount0 与 getView0 这 两 个 方法 即 可 ， 修 改 
“MyAdapterjava” 的 代码 如 下 : 
Public class MySimpleAdapter extends BaseAdapter { 
// 声 明 一 个 LayoutInflater 对 象 ( 其 作用 是 用 来 实例 化 布局 ) 


Private LayoutInflater mInflater; 
private List<Map<String，Object>> 1ist;// 声 明 List 容器 对 象 
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Private int layoutID; // 声 明 布局 ID 


private String flag[];// 声 明 ListView 项 中 所 有 组 件 映射 索引 
private int ItemIDs[];// 声 明 ListView 项 中 所 有 组 件 ID 数组 
public MySimpleAdapter (Context context, List<Map<String,Object>>list, 
int layoutID, String flag[], int ItemIDs[]) { 
// 利 用 构造 来 实例 化 成 员 变量 对 象 
this.mInflater = LayoutInflater.from(context); 
this.1list = list; 
this.layoutID = layoutID; 
this.flag = flag; 
this.ItemIDs = ItemIDs; 
} 
QOverride 
Public int getCount() { 
return list.size();// 返 回 ListView 项 的 长 度 


QOverride 
Public Object getItem(int arg0) { 
return 0; 


3 


QOverride 
Public long getItemId(int arg0) { 
return 0; 


有 
// 实 例 化 布局 与 组 件 以 及 设置 组 件数 据 
//getView (int position, View convertView, ViewGroup Parent) 
// 第 一 个 参数 : 绘制 的 行 数 
// 第 二 个 参数 : 绘制 的 视图 这 里 指 的 是 ListView 中 每 一 项 的 布局 
// 第 三 个 参数 ，view 的 合集 ， 这 里 不 需要 
QOverride 
Public View getView(int position, View convertView,ViewGroup Parent) { 
// 将 布局 通过 mInflater 对 象 实例 化 为 一 个 view 
convertView = mInflater.inflate (layoutID, null); 
for (int i = 0; i < flag.length; i++) {// 遍 历 每 一 项 的 所 有 组 件 
// 每 个 组 件 都 做 匹配 判断 ， 得 到 组 件 的 正确 类 型 
if (convertView.findViewById (ItemIDs [i]) instanceof 
ImageView) { 
//findViewById() 函数 作用 是 实例 化 布局 中 的 组 件 
// 当 组 件 为 ImageView 类 型 ， 则 为 其 实例 化 一 个 ImageView 对 象 
ImageView iv = (ImageView) convertView. 
findViewById (ItemIDs [i]); 
// 为 其 组 件 设置 数据 
iv.setBackgroundResource ( (Integer) list.get 
(Position) .get( 
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flag[il])); 
} else if (convertView.findViewById (ItemIDs[i]) 
instanceof TextView) { 


// 当 组 件 为 TextView 类 型 ， 则 为 其 实例 化 一 个 TextView 对 象 


TextView tv = (TextView) 
convertView.findViewById (ItemIDs[i]); 
/ /为 其 组 件 设置 数据 


tv.setText ( (String) 
list.get (position) .get (flag[i])); 


上 
// 为 按钮 设置 监听 


((Button) convertView.findViewById(R.id.btn) ) .setOnClickListener( 
new View.OnClickListener() { 
@Override 
Public void onClick(View v) { 
// 这 里 弹出 一 个 对 话 框 ， 后 文 有 详细 讲述 
new AlertDialog.Builder (MainActivity.ma) 
.SetTitle(" 自 定义 SimpleAdapter") 
.SetMessage (" 按 钮 成 功 触 发 监听 事件 ! ") 


.Show(); 


]) 7 
// 为 复 选 框 设 置 监听 
((CheckBox) convertView.findViewById(R.id.cb) ) . 
setOnCheckedChangeListener (new OnCheckedChangeListener() { 
QOverride 
Public void onCheckedChanged (CompoundButton buttonView, 
boolean isChecked) { 
// 这 里 弹出 一 个 对 话 框 ， 后 文 有 详细 讲述 
new AlertDialog.Builder (MainActivity.ma) 
.SetTitle ("有 自 定义 SimpleAdapter") 
.SetMessage ("CheckBox 成 功 触 发 状态 改变 监听 事件 ! ") 
.Show(); 
上 
1D); 
return convertView; 


关于 对 话 框 以 及 findViewById0) 与 LayoutInflater 的 区 别 ， 将 在 后 文 进行 详细 的 讲解 ， 这 
里 就 不 再 袭 述 。 代 码 直 接 修改 MainActivity 类 ， 将 初始 使 用 的 SimpleAdapter 修改 成 自 定义 的 
适配器 MySimpleAdapter， 最 后 运行 项 目 ， 效 果 如 图 3-37 所 示 。 
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@ 自 定 义 SimpleAdapter © 自 定 义 SimpleAdapter 
-二 CheckBox 成 功 触发 状态 改变 监 
按钮 成 功 甬 发 监听 事件 ! et 


图 3-37 ListView 实现 组 件 监听 


一点， 因为 ListView 每 一 项 中 都 有 其 他 焦点 的 组 件 ， 例 如 定义 的 Button 与 
CheckBox， 要 解决 这 个 问题 很 简单 ， 只 要 将 定义 的 Button 与 CheckBox 焦点 属性 设置 为 不 可 
见 就 可 以 了 ; 修改 布局 文件 中 定义 的 Button 与 CheckBox 组 件 ， 添 加 focusable 属性 ， 设 置 为 
false: 


<Button 
android:layout width="wrap Content" 
android:layout height="wrap content" 
android:text="button" 
android:id="@+tid/btn" 
android:focusable="false" 
/> 
<CheckBox 
android:layout width="wrap content" 
android:1layout height="wrap content" 
android:id="@+id/cb" 
android: focusable="false" 
/> 


再 次 运行 项 目 ， 效 果 如 图 3-38 所 示 。 


攻 一 EN 加 


图 3-38 ”获得 ListView 中 每 一 项 的 焦点 
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3. | Dialog 


在 Android 应 用 开发 中 ，Dialog (对 话 框 ) 创建 简单 且 易 于 管理 因而 经 常用 到 ， 对 话 框 
默认 样式 类 似 窗口 样式 的 Activitiy。 

首先 介绍 android.app.AlertDialog 下 的 Builder 这 个 类 。Builder 是 AlertDialog 类 的 子 类 ， 
而 且 还 是 它 的 内 部 类 。 正 如 其 名 所 示 ，Builder 相当 于 一 个 具体 的 构造 者 ， 通 过 Builder 设置 
对 话 框 属性 ， 然 后 将 Builder 〈 对 话 框 ) 显示 出 来 。 

打开 项 目 “DialogProject”， 源 代码 为 “3-11 (Dialog 对 话 框 ) ”， 不 需要 修改 布局 ， 直 
接 修改 源 代码 MainActivity.java: 


public class MainActivity extends Activity { 
Private Builder builder;// 声 明 Builder 对 象 
QOverride 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 
setContentView (R.layout.main); 
// 实 例 化 Builder 对 象 
builder = new Builder (MainActivity.this); 
// 设 置 对 话 框 的 图 标 
builder.setIcon (android.R.drawable.ic dialog info); 
// 设 置 对 话 框 的 标题 
builder.setTitle("Dialog"); 
// 设 置 对 话 框 的 提示 文本 
builder.setMessage ("Dialog 对 话 框 ") 
// 监 听 左 侧 按钮 
builder.setPositiveButton("Yes", new OnClickListener() { 
@Override 
Public void onClick (DialogInterface dialog, int which) { 
有 
1D); 
// 监 听 右 侧 按钮 
builder.setNegativeButton("No", new OnClickListener() { 
@Override 
Public void onClick (DialogInterface dialog, int which) { 
} 
1); 
// 调 用 show () 方 法 显示 出 对 话 框 


builder.show(); 
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显示 一 个 对 话 框 ， 首 先 创建 一 个 Builder 对 象 ， 然 后 设置 对 话 框 属 性 ， 最 后 调用 show() 
方法 将 对 话 框 显示 出 来 。 运 行 效果 如 图 3-39 所 示 。 


@ Dialog 


Dialog 对 话 框 


3-39 ”对 话 框 


对 话 框 中 最 多 可 以 设置 显示 3 个 按钮 ， 左 侧 对 应 的 是 PositiveButton， 中 间 对 应 的 是 
NeutralButton， 右 侧 对 应 的 是 NegativeButton， 在 使 用 Builder 对 其 按钮 来 设置 监听 器 的 时 候 
也 相当 于 设置 了 当前 按钮 显示 可 见 ， 而 且 对 话 框 默认 只 要 单 击 了 按钮 此 对 话 框 就 会 消亡 ; 
Android 对 Builder 有 特殊 的 设计 模式 ， 所 以 OnCreate 函数 的 代码 可 以 简写 成 以 下 形式 : 


new Builder (this) .setIcon(android.R.drawable.ic dialog info) . 
setTitle ("Dialog"). 


setMessage ("Dialog 之 \" 二 次 确认 \" 样 式 ") . 


setPositiveButton ("Yes", new OnClickListener() { 
Q@Override 


public void onClick(DialogInterface dialog, int which) { 
// TODO Auto-generated method stub 
} 


} ) .setNegativeButton("No", new OnClickListener() { 
@Override 


public void onClick(DialogInterface dialog, int which) { 
// TODO Auto-generated method stub 


}) .create().show(); 
Builder 类 中 还 有 一 个 setView() 的 方法 ， 此 方法 是 往 对 话 框 中 添加 系统 组 件 ， 例 如 可 以 在 
对 话 框 中 添加 一 个 CheckBox 按钮 : 
builder.setView (new CheckBox (this)); 
运行 效果 如 图 3-40 所 示 。 


这 里 需要 强调 一 点 ， 在 对 话 框 中 使 用 setView() 函 数 只 能 设置 一 个 组 件 ， 如 果 多 次 使 用 
setView(0) 也 不 会 有 错 ， 但 是 先 设 置 上 的 组 件 会 被 后 设置 的 组 件 替换 掉 。 


在 对 话 框 中 除了 可 以 设置 一 个 组 件 之 外 ， 还 可 以 同时 添加 单 选 框 和 复 选 框 ， 其 对 应 函数 
如 下 所 示 。 
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@ Dialog 


Dialog 对 话 框 


图 3-40 对话 框 中 添加 组 件 


(1) 添加 复 选 框 的 方法 

M, Builder.setMultiChoiceltems (String[]arg0,Boolean[]argl,OnMultiChoiceClickListener arg3 ) 

第 一 个 参数 : 表示 复 选 的 各 项 文本 ; 

第 二 个 参数 ， 表 示 复 选 的 各 项 选中 状态 ; 

第 三 个 参数 : 多 选单 击 监听 器 。 

(2) 添加 单 选 框 方法 

M Builder.setSingleChoiceltems (String[]Jarg0, int argl,OnClickListener arg3 ) 

第 一 个 参数 ， 表 示 单 选 的 各 项 文本 ; 

第 二 个 参数 : 表示 单 选中 默认 选中 的 下 标 ; 

第 三 个 参数 ， 单 击 监听 器 。 

首先 在 代码 中 添加 一 个 单 选 按钮 : 
builder.setSingleChoiceItems (new String[] {" 单 选 "," 单 选 "}，1，new 
OnClickListener() { 

@Override 


public void onClick (DialogInterface dialog, int which) { 
//which :选中 项 下 标 


一 


]) 7 


运行 项 目 ， 效 果 如 图 3-41 所 示 。 


图 3-41 添加 单 选 框 (错误 ) 
从 效果 图 中 看 出 ， 单 选 框 并 未 正常 显示 ; 其 实 出 现 这 种 错误 现象 的 原因 是 因为 对 话 框 的 


102 


第 3 章 Android 游戏 开发 常用 的 系统 控件 


提示 文本 和 单 选 框 布局 发 生 冲 突 了 ， 只 须 注释 掉 提 示 文 本 设置 ， 然 后 再 次 运行 项 目 ， 效 果 如 
图 3-42 所 示 。 


@@ Dialog 


图 3-42 添加 单 选 框 (正确 ) 


图 3-42 正确 显示 了 单 选 框 ， 可 以 证 实 是 因为 设置 了 提示 文本 的 缘故 ， 那 么 复 选 框 的 布局 
也 一 样 ， 也 就 是 说 对 话 框 默认 的 布局 中 提示 文本 、 单 选 框 、 复 选 框 是 相互 冲突 的 。 另 外 一 点 
就 是 setView() 添 加 一 个 系统 组 件 的 布局 ， 默 认 都 放 在 对 话 框 的 最 下 方 〈 即 按钮 上 方 ) 。 
接 下 来 ， 注 释 掉 添加 的 单 选 按钮 代码 ， 添 加 如 下 复 选 框 代码 : 
builder.setMultiChoiceItems (new String[] { "多 选 "，" 多 选 " }， 
new boolean[] { false, true }, new OnMultiChoiceClickListener() { 
QOverride 
public void onClick(DialogInterface dialog, int which, boolean 
isChecked) { 
//which: 选中 项 下 标 
//isChecked: 选中 项 的 勾 选 状态 


时 


运行 项 目 ， 效 果 如 图 3-43 所 示 。 


图 3-43 添加 多 选 框 
下 面 在 对 话 框 中 添加 一 个 简单 的 列表 。 注 释 掉 复 选 框 代码 ， 添 加 如 下 的 列表 代码 : 


builder.setItems (new String[] { "列表 项 1"，" 列 表 项 2"， "列表 项 3"” }, new 
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OnClickListener() { 
@Override 
Public void onClick(DialogInterface dialog, int which) { 
//which: 选 中 项 下 标 
上 
运行 效果 如 图 3-44 所 示 。 
0 Dialog 
列表 项 1 


列表 项 2 


列表 项 3 


3-44 添加 列表 


在 对 话 框 中 ， 除 了 能 添加 这 些 系统 组 件 以 外 ， 还 可 以 添加 自 定义 布局 。 其 方法 仍 是 使 用 
setView() 函 数 ， 因 为 每 个 布局 也 是 一 个 View。 为 了 让 其 布局 在 对 话 框 中 显示 出 来 ， 首 先 新 建 
-个 布局 文件 “dialogmain.xml”， 代 码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout height="wrap content" android:layout width="wrap content" 
android:background="#ffffffff" android:orientation="horizontal" 
android:id="@+id/myLayout "> 
<TextView 
android:layout height="wrap content" 
android:layout width="wrap content" 
android:text= "TextView" /> 
<EditText 
android:layout height="wrap content" 
android:layout width="wrap content" 
ea 
<Button 
android:layout height="wrap content" 
android:layout width="wrap content™" 
android:text="btn1" 
VW 
<Button 
android:layout height="wrap content" 
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android:layout width="wrap content" 
android:text=" btn2" 
> 

</LinearLayout> 


线性 布局 为 水 平方 向 ， 其 中 注册 了 一 个 TextView、 一 个 EditText 和 两 个 Button 。 
在 源 代码 对 话 框 设 置 布 局 之 前 ， 我 们 需要 对 新 定义 的 整个 布局 进行 实例 化 ， 否 则 在 屏幕 
中 什么 都 不 会 显示 。 对 话 框 设置 布局 代码 : 
// 实 例 layout 布局 
LayoutInflater inflater = getLayoutIinflater(); 
View layout = inflater.inflate(R.layout.aia1ogmainy 


(ViewGroup) findViewById (R.id.myTIayout) ) ; 
builder.setView (layout); 


运行 效果 如 图 3-45 所 示 。 代 码 中 LayoutInflater 的 作用 是 实例 化 一 个 布局 ， 其 详细 用 途 
在 后 文中 有 相应 的 讲解 。 


@ Dialog 


| Myrayoud | btn1 || btn2 
Yes No 


图 3-45 添加 自 定义 布局 


”系统 控件 常见 问题 


3.12.1 ”Android 中 常用 的 计量 单位 


Android 有 时 候 需要 一 些 计量 单位 ， 比 如 在 布局 Layout 文件 中 可 能 需要 指定 具体 单位 
等 。 常 用 的 计量 单位 有 : px、dip (dp) 、sp， 以 及 不 常用 的 pt、in、mm。 下 面 详细 介绍 一 
下 这 些 计量 单位 之 间 的 区 别 与 联系 。 
in :英寸 (长 度 单位 ) ; 
mm : 毫米 (长 度 单 位 ) ; 
pt : 磅 /点 ，1/72 英寸 (一 个 标准 的 长 度 单 位 ) ; 
sp: 全 名 scaled pixels 一 best for text size， 放 大 像素 ， 与 刻度 无 关 ， 可 以 根据 用 户 的 字 
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体 大 小 进行 缩放 ， 主 要 用 来 处 理 字 体 的 大 小 ; 

e px: 屏幕 中 的 像素 ; 

e dip (dp ) : 设备 独立 像素 ， 一 种 基于 屏幕 密度 的 抽象 单位 ; 因为 不 同 设备 中 有 不 同 
的 显示 效果 ， 所 以 为 了 解决 在 不 同 分 辩 率 手机 上 运行 不 至 于 相差 太 大 的 问题 ， 引 入 了 
dip 计量 单位 ， 这 种 计量 单位 与 移动 设备 硬件 无 关 。 


说 到 密度 ， 这 里 简单 介绍 一 下 ， 手 机 密度 值 (Density) 表示 每 英寸 有 多 少 个 显示 点 ， 与 
手机 的 分 辩 率 是 两 个 概念 ， 但 是 分 辩 率 与 密度 之 间 又 互相 有 关联 ， 两 者 转换 公式 为 : 


e@ 密度 值 是 120， 屏 幕 实 际 分 辨 率 为 : 240px x 400px ( 两 个 点 对 应 一 个 分 辨 率 ) ; 
@ 密度 值 是 160， 屏 幕 实际 屏 幕 分 辨 率 为 : 320px x 533px (3 个 点 对 应 两 个 分 辨 率 ) ; 
e 密度 值 是 240， 屏 幕 实 际 屏幕 分 辨 率 为 : 480px x 800px (一 个 点 对 于 一 个 分 辨 率 ) 。 


比如 ，QVGA 与 WQVGA 屏 的 密度 值 是 120，HVGA 屏 密 度 值 是 160，WVGA 屏 密度 值 
是 240。 

在 第 2 章 介绍 res 资源 目录 的 时 候 ， 曾 经 提 到 过 ， 因 为 运行 设备 的 不 同 ， 对 应 的 资源 文 
件 目录 也 不 同 。 其 实 真正 的 原因 是 ， 资 源 目录 是 根据 密度 的 不 同 来 进行 划分 的 ; 

e 密度 值 是 120， 对 应 资源 目录 为 drawable-ldpi; 

e@ 密度 值 是 160， 对 应 资源 目录 为 drawable-mdpi ; 

e@ 密度 值 是 240， 对 应 资源 目录 为 drawable-hdpi。 


根据 以 上 的 介绍 ， 在 布局 中 应 该 尽量 使 用 dip (dp ) 作为 单位 ;而 定义 作为 文字 大 小 
的 单位 则 推荐 使 用 sp。 


3.12.2 Context 

Context 类 是 一 个 抽象 类 ， 它 的 子 类 很 多 ， 比 如 Activity、TabActivity、Service 等 。 很 多 
方法 中 需要 传 入 Context 参数 才 可 实例 对 象 ， 例 如 Toast 实例 对 象 时 ， 第 一 个 对 象 需 传 入 
Context 对 象 。 其 实 Context 从 字面 上 可 理解 为 类 似 于 句柄 ， 联 系 上 下 文 的 意思 。 因 为 
Activity 是 Context 的 子 类 ， 所 以 一 般 在 Activity 中 使 用 Context 的 时 候 ， 可 以 用 this 来 代替 ， 
但 是 如 果 在 内 部 类 中 《〈 如 利用 内 部 类 使 用 监听 组 件 的 方式 中 ) ， 就 不 能 使 用 this 来 代替 
Context， 而 是 使 用 “ActName.this”， 这 里 的 ActName 指 的 是 Activity 类 的 类 名 。 

在 Android 中 的 Context 可 以 有 很 多 操作 ， 但 是 最 主要 的 功能 是 加 载 和 访问 资源 ， 这 里 也 
只 是 对 Context 做 一 个 简单 的 介绍 ， 其 更 多 的 使 用 方式 及 说 明 可 以 参看 Android 提供 的 API 文 
档 。 
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3.12.3 Resources 与 getResources 


在 Android 中 资源 (Resources) 都 会 自动 由 Rjava 资源 文件 生成 对 应 的 静态 ID， 通 过 R 
资源 文件 对 资源 生成 的 ID 来 引用 。 这 样 做 的 好 处 之 前 也 做 过 说 明 ， 即 在 资源 需要 修改 时 ， 
就 不 用 去 程序 源 代码 中 修改 ， 直 接 修改 对 应 res 下 的 资源 文件 即 可 。 

在 源 代码 中 ， 如 果 需 要 对 资源 目录 下 的 string.xml 中 定义 的 字符 串 变量 进行 访问 ， 只 需 
要 通过 getResources 的 方式 引用 即 可 。 

例如 需要 引用 string.xml 中 的 一 个 字符 串 ， 其 变量 名 为 “hello”， 获 取 的 方式 如 下 : 


getResources () .getString (R.string.hello); 


再 如 需要 引用 drawable 目录 下 的 一 张 名 为 “hello.png” 的 图 片 ， 获 取 的 方式 如 下 : 


getResources () .getDrawable (R.drawable .hello); 


当然 一 些 函 数 不 仅 支持 传 入 String 类 型 ， 也 支持 传 入 引用 ID。 例 如 TextView 中 的 
SetText() 函 数 ， 这 个 方法 不 仅 支持 传 入 String 类 型 ， 还 支持 R 文件 引用 ID 的 参数 。 
“R.string.strName ”中 的 strName 表示 在 string.xml 中 定义 的 字符 串 在 R 资源 文件 中 生成 的 对 
应 ID 索引 。 


3.12.4 findViewByld 与 Layoutlnflater 


LayoutInflater 的 作用 类 似 于 findViewById0， 两 者 不 同 之 处 在 于 LayoutInflater 是 用 来 实 
例 化 xml 布局 文件 中 的 布局 ， 而 findViewById0， 顾 名 思 义 ， 是 通过 ID 来 找到 xml 布局 文件 
中 定义 的 组 件 ， 比 如 EditText、TextView、Button 等 等 。 

关于 用 LayoutInflater 来 实例 布局 的 方式 有 两 种 : 


@ 通过 传 入 Context 参数 来 获得 LayoutInflater 实例 ， 然 后 调用 LayoutInflater 类 中 的 
inflate 函数 来 得 到 布局 实例 。 


LayoutInflater inflater = LayoutInflater.from(Context Context) 
View view=inflater.inflate (R.layout.ID, null); 


@ 通过 系统 服务 来 获取 到 LayoutInflater 实例 ， 然 后 调用 LayoutInflater 类 中 的 inflate 函 
数 来 得 到 布局 实例 。 
LayoutInflater inflater = (LayoutIinflater)getSystemService (LAYOUT INFLATER 


_SERVICE); 
View view=inflater.inflate (R.layout.ID, null); 


尽管 实例 布局 的 形式 不 同 ， 但 是 这 两 种 布局 方式 的 性 质 没有 区 别 。 
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3.12.5 ”多 个 Activity 之 间 跳 转 /退出 /传递 数据 操作 


在 介绍 Activity 生命 周期 的 时 候 ， 介 绍 过 多 个 Activitiy 之 间 的 跳 转 ， 但 是 没有 详细 讲解 
其 实现 方式 。 本 小 节 将 详细 讲解 一 下 Activitiy 中 常用 的 跳 转 、 传 递 数据 与 退出 操作 。 

首先 新 建 一 个 项 目 “OpenOtherActivity”， 源 代码 为 “3-12-5 (Activity 跳 转 与 操 
作 ) ”， 修 改 布局 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="fill parent™" 
android:layout height="fill Parent" 
> 
<TextView 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="This is MainActivity!" 
We 
<Button 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="OpenOtherActivity!" 
android:id="@+id/btnOopen" 
/> 
<Button 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="HideActivity" 
android:id="@+tid/btnHideActivity" 
/> 
<Button 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text="ExitActivity" 
android:id="@+id/btnExitActivity" 
Wes 
</LinearLayout> 


布局 中 注册 一 个 TextView 与 三 个 Button 组 件 ， 每 个 Button 都 定义 了 标题 与 ID， 然 后 再 
来 修改 MainActivity 中 的 源 代码 : 


public class MainActivity extends Activity implements OnClickListener { 
// 声 明 按钮 
Private Button btnOpen, btnHideActivity,btnExitActivity; 
Q@Override 
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public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 7 
setContentView(R.layout.main); 
// 实 例 按钮 
btnopen = (Button) findViewById(R.id.btnOpen); 
btnHideActivity = (Button) findViewById(R.id.btnHideActivity); 
btnExitActivity = (Button) findViewById(R.id.btnExitActivity); 
// 给 每 个 按钮 添加 监听 
btnOopen.setOnClickListener (this); 
btnHideActivity.setOonClickListener (this); 
btnExitActivity.setOonClickListener (this); 
public void onClick(View v) { 
if (v == btnOpen) { 
// 创 建 一 个 意图 ， 并 且 设 置 需 打开 的 Activity 
Intent intent = new Intent (MainActivity.this, 
OtherActivity.class); 
// 发 送 数据 
intent .putExtra ("Main"， "我 是 发 送 的 数据 ~ 娃哈哈 ") ; 
// 启 动 男 外 一 个 Activity 
this.startActivity (intent); 
} else if (v == btnHideActivity) { 
this.finish();// 退 出 Activity 
}else if (v == btnExitActivity) { 
System.exit(0);// 退 出 程序 
} 


上 面 的 源 代 码 实例 化 了 三 个 按钮 ， 并 且 在 三 个 按钮 上 绑 定 了 监听 器 ， 每 个 按钮 在 
onClick0 函 数 中 都 实现 了 处 理事 件 代 码 。 这 里 ， 对 实例 按钮 与 按钮 绑 定 监听 就 不 再 著述 ， 只 
把 注意 力 放 在 每 个 按钮 的 事件 处 理 代码 上 。btmnHideActivity 按钮 事件 调用 finish0 函 数 ， 并 退 
出 当前 的 Activity 操作 ;，btnExitActivity 按钮 事件 使 用 System.exit (0) 函数 ，“ 退 出 程序 ” 
操作 。 

在 代码 中 使 用 了 finishO0 和 System.exit (0) 语句 ， 它 们 的 区 别 如 下 : 

efinish() 函 数 表示 退出 当前 Activity。 执 行 此 函数 会 调用 生命 周期 中 的 onStop() 与 

onDestory() 函 数 ， 但 是 这 仅仅 是 将 当前 的 Activity 推 到 后 台 ， 程 序 中 的 资源 仍然 存 
在 ， 如 果 Android 运 行内 存 不 是 很 紧张 的 情况 下 ， 程 序 是 不 会 真正 退出 的 ; 
@ System.exit (0) 函数 表示 退出 当前 的 程序 。 当 Android 执行 到 此 函数 的 时 候 ， 本 应 用 


这 两 种 退出 方式 在 手机 进程 中 的 对 比如 图 3-46 所 示 。 
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使 用 finish ( ) 函数 使 用 System.exit(0) 函 数 
了 二 ( 更 SS 三 日、 
EE 并 
Name Name 
4 国 emulator-5554 4 国 emulator-5554 
system_process system_process 
jp.co.omronsoft.openwnn jp.co.omronsoft.openwnn 
com.android.phone com.android.phone 
com.android.launcher com.android.launcher 
android.process.acore android.process.acore 
com.android.defcontainer com.android.defcontainer 
com.android.mms com.android.mms 
com.android.protips com.android.protips 
com.android.quicksearchbox com.android.quicksearchbox 
com.openother 


3-46 ”手机 进程 对 比 图 
btnOpen 按钮 事件 用 于 打开 另外 一 个 Activity 并 且 附 带 数 据 的 传输 。 具 体 步 又 如 下 : 


所 到 于 了 》 先 声 明了 一 个 意图 ( Intent ) ， 实 例 意图 的 时 候 将 需要 打开 的 Activity 类 名 设置 在 
Intent 中 。 


Intent intent = new Intent (Context packageContext, class cls); 


第 一 个 参数 是 Context， 第 二 个 参数 为 被 启动 的 Activity 类 。 


intent .putExtra (String name, Object ob); 


第 一 个 参数 是 标识 字符 ， 类 似 与 哈 希 表 的 key 值 ， 第 二 个 参数 根据 需求 填 入 一 些 基 本 类 
型 ， 如 int、string、boolean 等 等 。 


然后 使 用 当前 Context 的 startActivity ( Intent intent ) 函数 即 可 启动 另外 一 个 Activity。 


到 此 ，MainActivity 的 代码 设计 完毕 ， 来 看 看 新 建 的 Activity 类 “OtherActivity. java” 的 
源 代 码 : 


public class OtherRActivity extends Activity { 

Private TextView tv; 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
tv = new TextView (this); 
setContentView (tv); 
// 得 到 当前 Activity 的 意图 
Intent intent = this.getIntent(); 
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// 获 取 数 据 

String str = intent.getStringExtra("Main"); 
// 将 获取 到 的 数据 设置 成 TextView 的 文本 
tv.setText (str); 


在 “OtherActivity” 类 中 ， 为 了 获取 传输 过 来 的 数据 定义 了 意图 对 象 。 但 是 这 里 不 要 去 
new 一 个 新 的 意图 ， 然 后 利用 当前 的 Activity 去 得 到 意图 的 实例 。 获 取 数据 的 时 候 ， 要 根据 
传输 的 数据 类 型 ， 使 用 相对 应 的 数据 类 型 来 获取 。 

打开 另外 一 个 Activity， 到 此 还 缺少 一 个 步骤 ， 因 为 OtherActivity 类 继承 的 是 Activity， 
也 是 一 个 活动 ， 那 么 之 前 讲 过 ， 当 新 建 一 个 Activity 的 时 候 ， 需 要 在 AndroidManifestxml 中 
声明 ， 和 否则 应 用 会 由 于 找 不 到 活动 而 报 异 常 ， 修 改 AndroidManifestxml 如 下 : 


<?xm]l version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package= "com. openother™" 
android:versionCode="1" 
android:versionName="1.0"> 
<application android:icon="@drawable/icon" 
android:label="@string/app_name"> 
<activity android:name=".MainActivity" 
android:label= "@string/app_name"> 
<intent-filter> 
<action android:name= "android. intent.action.MAIN" /> 
<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<!-- 下 面 是 注册 新 建 的 Activity (OtherActivity)--> 
<activity android:name=".OtherActivity" 
android:label="OtherActivity"/> 
</application> 
</manifest> 


AndroidManifest.xml 中 声明 了 一 个 Activity 活动 。 首 先 注意 其 语法 层次 ， 应 该 写 在 
<application> 标 签 的 下 一 层 ， 然 后 使 用 <activity> 声 明 新 的 活动 ， 最 后 设置 新 添加 的 Activity 的 
类 名 与 标题 或 者 其 他 的 属性 。 

单 击 “btnOpen ”按钮 事件 ， 程 序 执行 效果 如 图 3-47 所 示 。 
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图 3-47 打开 另外 一 个 Activity 效果 图 


3.12.6 ”横竖 屏 切 换 处 理 的 三 种 方式 


Android 手机 中 运行 应 用 的 时 候 ， 一 般 用 户 都 是 竖 屏 ， 但 是 如 果 突 然 将 手机 横 屏 ， 那 么 
很 可 能 就 会 造成 程序 出 现 异 常 ， 因 为 在 Android 中 每 次 屏幕 切换 会 重启 当前 的 Activity 。 这 种 
情况 下 ， 异 常 的 解决 方式 有 以 下 三 种 ， 对 应 的 源 代码 为 “3-12-6 (横竖 屏 切 换 处 理 ) ”。 

1. 锁定 横竖 屏 切 换 

此 方式 只 需要 在 AndroidManifest.xml 文件 中 ， 对 Activity 定义 屏幕 方向 属性 只 能 为 横 屏 
或 者 竖 屏 即 可 。 

。 将 屏幕 固定 为 坚 屏 显示 : 
<activity android:screenOrientation="portrait"> 

e 将 屏幕 固定 为 横 屏 显示 : 


<activity android:screenOrientation="landscape"> 


因为 一 个 Android 应 用 中 可 能 会 有 多 个 Activity， 那 么 可 以 根据 需要 去 配置 每 个 Activity 
的 显示 方式 ， 如 果 不 设 置 ， 默 认可 以 横竖 屏 切 换 。 或 者 在 源 代码 中 设置 横竖 屏 : 
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日 设置 坚 屏 : 

setRequestedOrientation (ActivityInfo.SCREEN ORIENTATION PORTRAIT); 
日 设置 横 屏 : 

setRequestedOrientation (ActivityInfo.SCREEN ORIENTATION LANDSCAPE); 
2 . 源 代码 中 处 理 横竖 屏 切 换 事 件 


首先 在 AndroidManifest.xml 中 对 Activity 注册 android:configChanges 属性 ， 然 后 在 对 应 
的 Activity 源 代码 中 重 写 onConfigurationChanged0 函 数 即 可 。 这 样 处 理 之 后 ， 当 横竖 屏 切 换 
的 时 候 ， 就 会 响应 其 Activity 中 的 onConfigurationChanged() 函 数 ， 然 后 对 屏幕 横竖 屏 做 判定 
处 理 就 可 以 了 。 


QOverride 
public void onConfigurationChanged (Configuration newConfig) { 
super.onConfigurationChanged (newConfig); 
if (this.getResources () .getConfiguration () .orientation == 
Configuration.ORIENTATION LANDSCAPE) { 
Log.e("Himi",， "当前 屏幕 切换 成 横 屏 显示 模式 ") ; 
} else if (this.getResources () .getConfiguration() .orientation == 
Configuration.ORIENTATION PORTRAIT) { 
Log.e("Himi",， "当前 屏幕 切换 成 竖 屏 显示 模式 ") ; 
. 


中 
使 用 此 方式 就 不 会 在 切换 横竖 屏 的 时 候 ，Android 默认 重启 当前 Activity 了 。 
3. 重 写 onSavelnstanceState() 与 onRestorelnstanceState() 函 数 
重 写 onSaveInstanceState() 与 onRestoreInstanceState() 函 数 代 码 如 下 : 
Q@Override 


Protected void onSaveInstanceState (Bundle outState) { 
super .onSaveInstanceState (outState); 
Log.e ("Himi", "ONSAVE"); 
} 
QOverride 
Protected void onRestoreInstanceState (Bundle savedInstanceState) { 


super .onRestoreInstanceState (savedInstanceState); 
Log.e("Himi", "ONRESTORE"); 


在 屏幕 切换 横竖 屏 的 时 候 ， 会 响应 onSaveInstanceState() 函 数 ， 然 后 重启 载 入 当前 
Activity， 最 后 响应 onRestoreInstanceState() 函 数 ， 所 以 可 以 通过 重 写 这 两 个 函数 ， 进 行 屏幕 
横竖 屏 切换 时 的 处 至 
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以 上 3 种 处 理 横竖 屏 切换 的 方式 ， 根 据 当 前 应 用 来 进行 选择 处 理 。 需 要 注意 的 是 ， 使 用 
Android 模拟 器 测试 ， 当 横 屏 切 换 成 竖 屏 时 ， 第 2 种 解决 方式 的 onConfigurationChanged() 函 
数 会 响应 两 次 。 第 3 种 解决 方式 会 啊 应 两 遍 onSaveInstanceState() 与 onRestoreInstance State() 
函数 。 不 过 大 家 放心 ， 这 只 是 Android 模拟 器 的 bug， 真 机 测试 没有 这 种 情况 。 


了 .| 3 本 章 小 结 


本 章 主要 介绍 了 布局 与 部 分 系统 组 件 ， 重 点 在 于 对 Android 提供 的 5 种 布局 要 熟练 掌握 
和 灵活 使 用 。 本 章 介 绍 的 组 件 都 是 在 游戏 中 比较 常用 的 ， 比 如 调整 游戏 的 音量 可 以 使 用 
SeekBar， 帐 号 注册 可 以 使 用 TextVew 与 EditText 等 等 。 对 于 Android 中 的 其 他 组 件 的 学 习 ， 
请 大 家 参考 相关 书籍 。 
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从 本 章节 可 以 学 习 到 : 

党 如 何 快速 的 进入 Android 
游戏 开发 

学 游戏 的 简单 概括 

学 Android 游戏 开发 中 常用 
的 三 种 视图 

学 View 游戏 框架 

党 SurfaceView 游戏 框架 

党 View 与 SurfaceView 的 
区 别 

党 Canvas 画布 


游戏 开发 基础 


Paint 画笔 

Bitmap 位 图 的 泻 染 与 操 
作 

剪 切 区 域 

动画 

游戏 适 屏 的 简 述 与 作用 
让 游戏 主角 动 起 来 

碰撞 检测 

游戏 音乐 与 音效 

游戏 数据 存储 


Android 游 戏 编程 之 从 零 开 始 


A .| 如 何 快速 的 进入 Android 游戏 开发 


从 本 章 开始 我 们 正式 进入 Android 游戏 开发 基础 知识 的 学 习 。 对 于 如 何 才 能 快速 地 学 
Android 游戏 开发 ， 本 节 跟 大 家 分 享 一 些 编者 的 学 习 经 验 和 方法 。 


1 . 不 可 盲目 看 AP 文档 


很 多 人 在 接触 学 习 一 门 新 的 平台 语言 时 ， 总 是 喜欢 先 去 探究 一 番 API 文档 。 先 不 说 成 效 
如 何 ， 至 少 编者 认为 这 种 方式 不 适合 大 部 分 人 来 效仿 ， 主 要 原因 在 于 API 领域 广泛 ， 牵 涉 到 
的 知识 点 太 多 ， 而 对 于 刚刚 接触 平台 开发 语言 的 大 部 分 人 来 说 ， 遗 忘 的 速度 远 远大 于 记忆 ! 
这 种 做 法 是 大 量 消耗 精力 、 小 量 吸取 知识 的 方法 ， 只 会 事倍功半 。 


2 . 前 人 铺路 ， 后 人 乘凉 

对 于 初学 者 来 说 ， 任 何 想 要 学 习 与 掌握 的 知识 点 ， 之 前 都 会 有 高 人 学 习 总 结 过 ; 所 以 建 
议 大 家 每 学 习 一 个 知识 点 ， 都 尽 可 能 的 先 动手 去 网 上 搜索 和 学 习 别 人 总 结 出 来 的 相关 知识 点 
的 文章 ， 毕 竞 前 人 总 结 过 的 知识 会 让 你 减少 学 习 的 弯路 。 最 后 再 根据 每 个 知识 点 去 详细 翻阅 
相关 的 API 文档 ， 有 针对 性 、 有 目的 性 的 去 看 API 文档 才 会 事半功倍 。 


3 . 好 记性 不 如 烂 笔 头 


这 名 谚语 ， 几 乎 无 人 不 知 无 人 不 晓 ， 人 在 学 习 的 时 候 ， 总 
是 看 代码 的 多 ， 而 动手 练习 代码 的 少 ! 身 为 一 个 程序 员 都 应 该 很 清楚 ， 代 码 如 果 不 多 动手 敲 
它 ， 它 永远 不 会 自己 跑 进 脑 中 ， 也 以 多 动手 才 是 记 贡 的 关键; 


4 . 养 成 自学 的 习惯 

学 习 新 的 知识 如 果 总 是 抱 着 依赖 和 期 望 别 人 手把手 教授 ， 那 就 太 不 现实 了 。 因 为 没有 任 
何 一 个 人 能 时 时 刻 刻 的 陪 在 身边 给 予 帮 助 ， 但 是 使 用 Baidu 和 Google 可 以 做 到 ! 它们 拥有 着 
最 全 的 资源 库 ， 使 用 它们 可 以 查找 到 最 强 的 技术 ， 不 过 ， 它 们 永远 都 只 在 那里 等 待 你 去 使 用 
它们 ， 如 果 你 不 动手 去 搜索 ， 那 么 对 于 你 来 说 它们 毫 无 用 处 ! 


5 . 利用 小 项 目 实战 进步 快 


在 学 习 游戏 开发 时 ， 一 定 要 多 做 小 项 目 ， 比 如 今天 学 会 了 一 个 新 的 知识 点 ， 那 么 首先 就 
要 尽 可 能 发 散 思维 ， el 并 在 游戏 中 起 到 什么 样 
的 作用 等 等 。 然 后 拿 出 时 间 一 定 要 去 写 一 个 小 项 目 练习 新 知识 点 。 

写 小 项 目 有 两 点 好 处 : 一 是 巩固 新 知识 点 ， 二 是 通过 小 项 目 发 现 知识 点 实际 应 用 到 游戏 
中 会 出 现 的 问题 ,有 些 问 题 不 亲自 动手 编写 是 根本 无 法 发 现 的 。 
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6 . 进步 来 源 于 问题 

好 程序 不 是 写 出 来 的 ， 是 改 出 来 的 ! 这 句 话 没有 人 能 反驳 ， 因 为 谁 写 代码 都 不 可 能 是 一 
遍 成 功 ， 不 用 修改 ， 不 用 完善 的 。 

学 习 中 遇 到 问题 时 ， 不 应 该 烦躁 而 是 应 该 庆幸 ， 因 为 解决 掉 问 题 就 意味 着 进步 。 千 万 不 
能 遇 到 问题 不 假 思索 就 去 请 教 他 人 ， 这 样 解决 掉 的 问题 没有 任何 的 意义 ， 并 且 请 教 他 人 ， 就 
是 在 给 他 人 创造 一 个 学 习 或 温习 的 机 会 ! 

当然 这 里 不 推荐 大 家 遇 到 问题 一 定 就 铁 下 心 的 自己 去 几 天 几 夜 的 钻研 ， 应 该 自我 把 握 问 
题 的 难 易 度 ， 如 果 问 题 确实 超出 自己 能 力 的 ， 那 请 教 他 人 反而 对 自己 更 有 帮助 ， 有 效率 ， 前 
提 是 自己 考虑 过 如 何 解决 此 问题 。 

其 实 ， 游戏 开发 的 学 习 过 程 应 该 是 一 个 拼图 的 过 程 。 首 先 要 分 模块 来 学 习 ， 积 累 了 一 定 
的 模块 知识 后 ， 再 通过 这 些 模块 就 可 以 拼 出 各 种 类 型 、 各 种 风格 的 游戏 。 因 此 ， 后 续 章节 中 
将 以 模块 的 形式 来 进行 详解 ， 并 且 最 后 会 综合 利用 各 个 模块 完成 一 个 实战 项 目 。 下 面 我 们 就 
开始 游戏 开发 的 学 习 。 

为 了 便于 讲解 ， 本 章 所 有 项 目的 创建 统一 选用 Android 1.6-API 4 版 本 ; 模拟 器 则 统一 使 
用 如 图 4-1 所 示 的 属性 配置 ，HVGA 默认 索引 资源 文件 夹 为 drawable-mdpi。 


四 y 
圈 create new Android Virtual Device (AVD) [一 > 一 | 


Name: Himi-Android1.6 


Target [Android16- Apl Level 4 -| 
SD Card: 
@ Size: 20 MiB ~ 
3 File: Browse 
Snapshot: 
回 Enabled 
Skin: 
® Buitin [HVGA ~ 
D Resolution: x 
Hardware: 
Property Value [ev 
SD Card support yes 


Delet 
Abstracted LCD density 160 es 


Max VM application h.. 24 


Override the existing AVD with the same name 


4-1 模拟 器 的 属性 配置 


A 
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上 一 章 为 大 家 介绍 了 一 些 Android 自 带 的 常用 组 件 ， 这 些 组 件 就 像 是 Google 为 开发 者 提 
供 的 开发 引擎 一 样 ， 开 发 者 只 需要 知道 如 何 使 用 ， 并 不 要 求知 道 其 底层 是 如 何 实现 的 。 从 本 
章 开始 进入 游戏 开发 ， 首 先 提 醒 读者 注意 的 一 点 是 : 不 管 是 否 有 过 Android 软件 开发 的 经 
验 ， 作 者 希望 读者 尽 可 能 地 忘却 之 前 软件 开发 的 流程 和 思维 ， 换 种 眼光 和 思路 去 看 待 、 去 找 
到 属于 游戏 开发 专 有 的 流程 与 设计 思想 。 

在 游戏 开发 中 ， 一 般 很 少 使 用 系统 提供 的 组 件 进行 开发 ， 其 主要 原因 在 于 游戏 的 多 样 
性 。 比 如 简单 的 一 款 “ 连 连 看 ”游戏 ， 它 就 可 以 拥有 N 种 玩法 、N 种 场景 、N 种 风格 、N 种 
元 素 。 所 以 ， 如 果 还 期 望 从 系统 中 找到 对 应 组 件 的 话 ， 结 果 会 令 人 很 失望 ， 不 是 系统 不 想 提 
供 ， 而 是 它 永 远 都 无 法 知道 将 要 制作 的 游戏 类 型 、 风 格 等 等 。 

总 结 一 句 话 : 开发 一 款 游 戏 ， 请 用 自己 的 双手 为 这 款 游 戏 创 建 专属 它 的 组 件 ! 换言之 ， 
就 是 要 自己 去 实现 游戏 中 的 组 件 ， 不 要 再 一 味 的 幻想 系统 能 为 你 带 来 什么 。 系 统 只 能 提供 
“一 支 笔 ”、“ 一 张 画布 ”， 仅 此 而 已 。 至 于 能 创造 出 多 么 精彩 的 游戏 世界 ， 那 完全 取决 于 
游戏 开发 者 。 


人 .7 游戏 的 简单 概括 


对 于 玩家 来 说 ， 游 戏 是 动态 的 ， 对 于 游戏 开发 人 员 来 说 ， 游 戏 是 静态 的 ， 只 是 在 不 停 地 
播放 不 同 的 画面 ， 让 玩家 看 到 了 动态 效果 。 

进入 Android 游戏 开发 之 前 ， 首 先 要 熟悉 三 个 重要 的 类 : View (视图 ) 、Canvas ( 画 
布 ) 、Paint (画笔 。 通 过 画笔 ， 可 以 在 画布 上 画 出 各 种 精彩 的 图 形 、 图 片 等 等 ， 然 后 通过 
视图 可 以 将 画布 上 的 内 容 展现 在 手机 屏幕 上 。 

其 次 要 熟悉 “ 刷 屏 ” 的 概念 。 绘 制 在 画布 中 的 图 像 不 管 是 图 片 还 是 图 形 ， 都 是 静态 的 ， 
只 有 通过 不 断 地 展现 不 同 的 画布 ， 才 能 实现 动态 的 效果 。 在 手机 上 ， 画 布 永远 只 是 一 张 ， 所 
以 不 可 能 通过 不 断 地 播放 不 同 的 画布 来 实现 动态 效果 ， 这 时 就 需要 对 画布 进行 刷新 来 实现 动 
态 效果 。 

刷新 画布 如 同 使 用 一 块 橡皮 擦 ， 擦 去 之 前 画布 上 的 所 有 内 容 ， 然 后 重新 绘制 画布 ， 如 此 
反复 ， 形 成 动态 效果 ， 而 擦拭 画布 的 过 程 则 称 为 刷 屏 (刷新 屏幕 ) 。 刷 屏 的 更 多 详细 内 容 会 
在 后 文 讲述 ， 例 如 不 刷 屏 带 来 的 后 果 等 等 。 下 面 我 们 就 开始 学 习 Android 游戏 开发 中 常用 的 
三 种 视图 吧 。 


外 .3 Android 游戏 开发 中 常用 的 三 种 视图 


Android 游戏 开发 中 常用 三 种 视图 是 View 、SurfaceView 和 GLSurfaceView。 这 三 种 视图 
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第 4 章 ”游戏 开发 基础 


的 关系 如 图 4-2 所 示 。 


ava.lang.Object 
Landroid view. View 
Landroidview.SurfaceView 
Landroid.opengl.GLSurfaceView 


图 42 三 种 视图 关系 树 状 图 
下 面 简单 介绍 这 三 种 视图 的 含义 。 


@ View: 显示 视图 ， 内 置 画 布 ， 提 供 图 形 绘制 函数 、 触 屏 事 件 、 按 键 事件 函数 等 ; 

@ SurfaceView: 基于 View 视图 进行 拓展 的 视图 类 ， 更 适用 于 2D 游戏 开发 ; 

e@ GLSurfaceView: 基于 SurfaceView 视图 再 次 进行 拓展 的 视图 类 ， 专 用 于 3D 游戏 开发 
的 视图 。 


另外 使 用 GLSurfaceView 支持 GPU 加 速 ， 通 过 真 机 测试 发 现 ， 此 视图 在 GPU 加 速 下 泻 
染 2D 图 形 方面 的 效率 要 远 远 高 于 View 与 SurfaceView 30 倍 左右 ; 但 View 与 SurfaceView 的 
效率 基本 已 经 满足 大 部 分 游戏 开发 的 要 求 ， 并 且 由 于 GLSurfaceView 渔 染 位 图 都 与 openGL 
的 知识 相关 ， 这 里 就 不 再 多 加 讲解 ， 有 兴趣 的 可 以 参阅 相关 资料 。 

本 书 主要 讲解 的 是 2D 游戏 开发 ， 所 以 GLSurfaceView 类 和 暂且 不 细 说 ， 而 关于 View 
与 SurfaceView 的 区 别 ， 可 以 在 大 家 熟悉 这 两 种 视图 后 再 进行 详细 剖析， 这 里 就 简单 说 一 
句 : View 与 SurfaceView 是 Android 游戏 开发 最 常 使 用 的 两 种 视图 。 所 以 在 2D 游戏 开发 
中 ， 可 以 大 致 分 为 两 种 游戏 框架 ， 一 种 是 View 游戏 框架 ， 另 外 一 种 是 SurfaceView 游戏 
框架 。 


4 。 4 View 游戏 框架 


本 节 我 们 介绍 View 游戏 框架 。 先 来 看 一 个 范例 ， 新 建 一 个 项 目 GameView， 如 图 4-3 所 
示 。 本 项 目 对 应 的 源 代码 为 “4-3 (View 游戏 框架 ) ”。 
项 目 创建 完毕 之 后 ， 首 先 自 定义 一 个 视图 类 “MyView” 继 承 View 类 ， 代 码 如 下 : 


119 


New Android Project 
Creates a new Android Project resource. 
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public boolean onKeyDown (int keyCode, KeyEvent event) { 
return super.onKeyDown (keyCode, event); 

3’ 

/** 

* 重 写 按键 抬 起 事件 函数 

区 克 

Qoverride 

public boolean onKeyUp (int keyCode, KeyEvent event) { 
return super.onKeyUp (keyCode, event); 

} 

/** 

* 重 写 触 屏 事件 函数 

ed 

Q@Override 

public boolean onTouchEvent (MotionEvent event) { 
return super.onTouchEvent (event); 

} 


本 类 中 实现 的 函数 都 是 重 写 了 父 类 View 中 的 函数 ， 当 然 View 中 的 函数 不 止 这 些 ， 可 以 
根据 需要 来 重 写 。 比 如 在 游戏 开发 中 ， 最 需要 重 写 View 的 onDraw 绘图 函数 ， 以 及 玩家 对 按 
键 按 下 和 抬 起 的 事件 监听 函数 onKeyDown/onKeyUp、 和 触 屏 事件 监听 函数 onTouchEvent 等 。 


在 Eclipse 中 重 写 父 类 函数 ， 操 作 如 下 : 单 击 主 菜单 的 “Search” 项 ， 选 中 “Override/ 


Implement Methods...” 选 项 ， 然 后 在 出 现 的 “Override/Implement Method” 窗 口中 ， 选 中 
需要 重 写 的 函数 ， 最 后 单 击 “OK?” 按 钮 即 可 (Eclipse 中 默认 使 用 ShifttAlttS 组 合 快捷 键 
调 出 Source 选项 ) 。 


下 面 修改 MainActivity 活动 类 让 屏幕 来 显示 MyView 类 : 


Public class MainActivity extends Activity { 
@Override 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 
// 设 置 显示 View 实例 
setContentView (new MyView (this)); 


此 时 运行 项 目 是 看 不 到 任何 效果 的 ， 只 能 看 到 手机 屏幕 全 黑 ， 这 是 因为 默认 画布 颜色 为 黑 
色 。 
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4.4.1 ”绘图 函数 onDraw 


不 管 绘制 文本 、 图 形 还 是 图 片 等 等 ， 首 先 需 要 的 肯定 是 一 个 画布 。 而 View 类 提供 的 实 
例 中 就 有 一 个 画布 实例 ， 这 个 画布 实例 存在 于 View 的 绘制 函数 onDraw 的 参数 中 ， 这 也 就 是 
说 ， 在 画布 上 进行 的 一 切 绘制 都 应 该 添加 到 此 绘制 函数 中 。 

我 们 尝试 一 下 在 画布 上 绘制 文本 。 修 改 MyView 类 ， 在 onDraw 函数 中 添加 如 下 代码 : 
Protected void onDraw (Canvas canvas) { 

// 创 建 一 个 画笔 的 实例 

Paint paint = new Paint(); 

// 设 置 画 笔 的 颜色 

paint.setColor (Color .WHITE); 

/ /绘制 文 本 

canvas.drawText ("Game", 10, 10, paint); 

super.onDraw (canvas); 


在 上 面 代码 中 ，Paint 的 setColor 函数 只 有 一 个 参数 ， 传 入 的 是 一 个 int 值 。Color 是 
Android 封装 的 颜色 类 ， 类 中 有 很 多 静态 颜色 常量 提供 使 用 。 当 然 此 处 的 颜色 值 ， 也 可 以 使 
用 十 六 进 制 来 表示 的 。“paint.setColor(Color.WHITE);” 等 同 于 “paint. setColor(Oxfffffffp;”。 使 
用 十 六 进 制 的 好 处 是 更 灵活 ， 因 为 使 用 十 六 进 制 来 表示 的 int 的 四 个 字 节 分 别 表 示 透 明度 、 
红色 分 量 、 蓝 色 分 量 、 绿 色 分 量 ; 这 样 不 仅 可 以 通过 这 个 十 六 进 制 的 数 设置 画笔 透明 度 ， 也 
能 设置 画笔 为 各 种 需要 的 颜色 。 

Canvas 的 drawText 函数 有 四 个 参数 。 第 一 个 参数 : String 类 型 ， 指 文本 信息 ; 第 二 个 与 
第 三 个 参数 分 别 指 文本 绘制 在 屏幕 中 的 X、Y 位 置 坐标 〈 默 认 绘 制 文字 以 文字 的 左下 角 为 锚 
点 ) ; 第 四 个 参数 是 画笔 实例 。 

大 家 不 要 奇怪 为 什么 绘制 文本 的 函数 不 在 Paint 画笔 类 中 ， 这 是 因为 在 Android 中 ， 绘 制 
图 形 、 图 片 等 函数 都 是 放 在 画布 类 里 ， 由 画布 实例 来 调用 这 些 函 数 进行 绘图 。 而 画布 进行 绘 
图 时 ， 画 笔 当 然 也 是 不 可 少 的 元 素 ， 只 是 这 里 画笔 作为 画布 在 绘图 时 以 参数 形式 出 现 了 。 

运行 项 目 ， 效 果 如 图 4-4 所 示 。 


岛 丽 大 4:52PM 


图 4-4 在 屏幕 中 显示 文本 
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图 4-4 箭头 指向 的 “Game” 字 样 就 是 绘制 的 文本 了 ， 从 图 中 可 以 发 现 文本 被 应 用 名 履 盖 
了 ， 这 是 因为 没有 设置 屏幕 全 屏 的 缘故 。 
下 面 为 应 用 程序 设置 全 屏 。 修 改 MainActivity 类 如 下 : 


Public class MainActivity extends Activity { 

@Override 

Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
// 隐 去 标题 栏 ( 应 用 程序 的 名 字 》 
this.requestWindowFeature (Window. FEATURE NO TITLE); 
// 隐 去 状态 栏 部 分 (电池 等 图 标 和 一 切 修饰 部 分 ) 
this.getWindow () .setFlags (WindowManager.LayoutParams .FLAG FULL 

SCREEN, WindowManager.LayoutParams.FLAG FULLSCREEN); 

// 设 置 显示 View 实例 


setContentView (new MyView (this)); 


设置 全 屏 的 操作 主要 就 两 点 : 隐 去 状态 栏 部 分 ， 包括 电 池 等 图 标 ， 把 应 用 的 名 字 也 隐 去 不 
显示 。 这 样 一 来 设置 全 屏 就 完成 了 ， 然 后 再 次 运行 项 目 观 察 。 要 注意 一 点 : 设置 隐 去 标题 栏 
必须 在 显示 View 视图 之 前 完成 ， 否 则 程序 会 导致 异常 。 

再 次 运行 项 目 ， 效 果 如 图 4-5 所 示 。 


图 4-5 设置 应 用 程序 全 屏 


除了 代码 设置 隐 去 应 用 标题 和 状态 栏 外 ， 还 可 以 通过 在 项 目的 AndroidManifest.xml 文件 
中 对 Activity 的 属性 进行 配置 来 实现 。 
隐 去 应 用 标题 : 


android:theme="@android: style/Theme .NoTit1leBarn" 


设置 全 屏 〈 隐 去 状态 栏 和 应 用 标题 ) : 


android:theme="@android:style/Theme.NoTitleBar.Fullscreen" 
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这 里 再 介绍 一 下 手机 屏幕 XY 坐标 位 置 的 小 知识 ， 手 机 屏幕 XY 坐标 如 图 4-6 所 示 。 


(0.0) X 轴 正方 向 (0.0) 向 

Y 
轴 

总 正 

正 方 

方 向 

向 

sam NN 


4-6 手机 横竖 屏 X、Y 坐标 轴 


手机 屏幕 不 论 横 屏 ， 还 是 竖 屏 ， 手 机 的 最 左上 角 的 点 永远 是 〈0,0) 点 ;而 手机 屏幕 的 
(0.0) 点 水 平 向 右 永远 是 X 轴 正方 向 ，《〈0,0) 点 垂直 向 下 永远 是 立轴 的 正方 向 。 


4.4.2 ”按键 监听 


在 一 款 游戏 中 ， 与 玩家 交互 的 主要 途径 就 是 手机 按键 或 玩家 触摸 屏幕 这 两 种 事件 。 在 
View 视图 类 中 已 经 封装 了 这 些 函 数 ， 只 要 重 写 按键 、 触 屏 监听 函数 即 可 获取 当前 玩家 点 击 的 
是 什么 按键 或 者 玩家 点 击 屏幕 的 位 置 是 哪里 。 

按键 监听 有 两 个 函数 : 


e onKeyDown: 按键 被 按 下 时 响应 的 函数 ; 
e onKeyUp: 按键 抬 起 时 响应 的 函数 。 


触 屏 监听 函数 只 有 一 个 : 


e@_ onTouchEvent: 触 屏 时 响应 的 函数 。 

到 这 里 大 家 可 能 会 疑惑 ， 实 体 按键 监听 分 别 对 应 有 抬 起 和 按 下 两 种 函数 的 监听 ， 那 么 触 
屏 事件 为 什么 只 有 一 个 ?手指 按 下 屏幕 和 手指 离开 屏幕 是 如 何 监听 的 ? 其 实 触 屏 监听 函数 不 
只 是 玩家 手指 按 下 时 触发 响应 ， 当 手指 离开 屏幕 、 手 指 在 屏幕 中 滑动 等 动作 都 可 以 通过 此 函 
数 完成 监听 。 

下 面 我 们 修改 刚才 的 项 目 ， 实 现 让 “Game” 字 样 的 文本 通过 实体 方向 按键 控制 其 移动 。 

让 文本 的 坐标 随 着 方向 按键 的 方向 来 移动 ， 其 实 就 是 改变 绘制 文本 的 X、Y 坐标 ; 那么 
此 时 为 了 在 按键 监听 函数 中 设置 文本 坐标 ， 将 文本 的 X、Y 坐标 定义 为 成 员 变量 。 首 先 定义 
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Private int textX=20, textY=20; 


然后 修改 绘制 函数 如 下 : 


QOverride 
Protected void onDraw (Canvas canvas) { 
// 创 建 一 个 画笔 的 实例 
Paint paint = new Paint(); 
// 设 置 画 笔 的 颜色 
paint.setColor (Color .WHITE); 
// 绘 制 文 本 
canvas.drawText ("Game", textX, textY, paint); 
super .onDraw (canvas); 


这 里 要 修改 的 就 一 点 :将 绘制 文本 的 固定 坐标 换 成 了 定义 的 成 员 坐 标 (textX, textY) ， 这 
样 一 来 只 要 改变 textX, textY 的 值 就 可 以 了 。 最 后 编写 按键 事件 监听 函数 的 代码 如 下 : 


QOverride 
public boolean onKeyDown (int keyCode, KeyEvent event) { 
// 判 定 用 户 按 下 的 键 值 是 否 为 方向 键 的 * 上 下 左右 “ 键 
if (keyCode == KeyEvent .KEYCODE DPAD UP) { 
// 人 "上 ”按键 被 点 击 ， 应 该 让 文本 的 Y 坐标 变 小 
textY-=2; 
} else if (keyCode == KeyEvent .KEYCODE DPAD DOWN) { 
// 下“ 按键 被 点 击 ， 应 该 让 文本 的 并 坐标 变 大 
textY+=2; 
} else if (keyCode == KeyEvent.KEYCODE DPAD LEFT) { 
//" 左 “按键 被 点 击 ， 应 该 让 文本 的 X 坐标 变 小 
textX-=2; 
} else if (keyCode == KeyEvent.KEYCODE DPAD RIGHT) { 
/A" 右 “按键 被 点 击 ， 应 该 让 文本 的 X 坐标 变 大 
textX+=2; 
. 
return super.onKeyDown (keyCode, event); 


按键 按 下 事件 监听 函数 
public boolean onKeyDown (int keyCode, KeyEvent event) {} 
其 中 ， 两 个 参数 的 含义 如 下 : 


eint keyCode: 指 的 是 当前 用 户 点 击 的 按键 ; 
e KeyEvent event: 指 的 是 按键 的 动作 事件 队列 ， 此 类 还 定义 了 很 多 静态 常量 键 值 。 


通过 keyCode 与 手机 键 值 的 配对 来 确定 当前 用 户 的 按键 ;一 旦 匹配 到 需要 的 键 值 后 ， 就 
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可 以 处 理 响 应 的 逻辑 了 。 就 像 这 里 ， 如 果 希 望 玩家 按 下 手机 的 四 个 方向 按键 后 再 去 移动 文本 
的 位 置 ， 可 以 利用 keyCode (当前 用 户 按 下 的 按键 键 值 ) 与 所 需 的 键 值 匹 配 来 判定 用 户 当 前 
是 否 按 下 了 对 应 的 键 值 。 一 旦 匹配 键 值 相同 ， 就 开始 分 别处 理 四 个 方向 按键 应 该 处 理 的 逻辑 
代码 ， 这 里 是 对 文本 的 坐标 进行 修改 。 

到 此 为 止 就 基本 完成 了 按键 控制 文本 移动 的 设计 ， 但 是 遗憾 的 是 ， 当 运行 项 目 后 发 现 按 
下 手机 的 四 个 方向 键 ， 文 本 没有 任何 的 位 置 改变 。 文 本 位 置 没 有 发 生 改 变 这 是 正常 的 现象 ， 
因为 当前 的 按键 按 下 时 ， 监 听 函 数 并 没有 在 监听 ， 原 因 在 于 没有 设置 当前 View 获取 焦点 。 

所 谓 给 当前 View 设置 焦点 ， 其 实 就 是 告诉 系统 ， 现 在 这 个 视图 需要 与 用 户 交 互 ， 让 系 
统 来 监听 此 视图 。 因 为 一 个 界面 中 可 以 显示 多 个 View 视图 ，Android 为 了 避免 出 现 多 个 
View 焦点 混乱 的 问题 ，View 类 有 了 焦点 属性 ， 以 及 对 应 的 设置 焦点 的 方法 。 设 置 焦点 的 函 
数 如 下 : 


setFocusable (true); 


此 函数 要 求 传 入 一 个 布尔 值 的 参数 ，true 表示 设置 焦点 ，false 表示 当前 视图 不 需要 焦 
点 。 视 图 只 要 设置 一 遍 焦 点 即 可 。 我 们 可 以 将 设置 焦点 操作 写 在 当前 自 定义 的 MyView 
(View) 构造 函数 中 : 

Public MyView (Context context) { 


super (context); 
setFocusable (true); 


此 时 再 次 运行 项 目 ， 单 击 手机 方向 键 ， 发 现 文本 位 置 仍旧 没有 发 生 改变 。 别 着 急 ， 这 也 
是 正常 现象 ， 下 面 解释 其 原因 。 

View 的 onDraw 函数 虽然 是 绘制 函数 ， 但 是 此 函数 只 会 在 View 视图 一 开始 创建 运行 的 
时 候 执 行 一 遍 而 已 。 所 以 即使 通过 按键 改变 了 绘制 的 文本 坐标 ， 但 是 看 到 的 仍然 是 之 前 的 画 
布 ， 不 是 最 新 的 画布 状态 ， 如 果 想 看 到 最 新 的 画布 则 需要 重新 绘制 画布 。 
重新 绘制 画布 的 方法 ，View 类 也 提供 了 相应 的 两 个 函数 ， 而 且 这 两 个 函数 都 会 再 次 调用 
onDraw 函数 。 


e invalidate() 


® postInvalidate() 


这 两 个 重新 绘制 画布 的 函数 的 主要 区 别 是 : invalidate() 方 法 不 能 在 当前 线程 中 循环 调用 
执行 ， 这 里 所 说 的 线程 不 是 系统 的 主 UI 线程 ， 而 是 指 的 子 线 程 (自己 创建 的 线程 》; 而 
postInvalidate() 函 数 可 以 在 子 线 程 中 循环 调用 执行 。 如 果 不 在 当前 View 创建 线程 循环 重 绘 画 
布 的 话 ， 这 两 种 重 绘画 布 的 函数 就 没什么 区 别 了 ， 都 可 以 使 用 。 

知道 了 重 绘画 布 的 方法 之 后 ， 紧 接着 要 考虑 的 是 ， 重 绘 函 数 方法 添加 在 哪里 ， 这 个 问题 
其 实 要 根据 实际 情况 而 定 了 。 比 如 当前 要 做 的 是 一 个 让 文本 移动 的 效果 ， 那 么 改变 文本 的 坐 
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标 只 是 在 按键 后 被 修改 ， 所 以 可 以 将 重 绘 函数 加 到 按键 监听 的 函数 中 。 这 种 情况 下 ， 如 果 要 
求 游戏 的 画布 每 隔 国定 时 间 刷 新 一 次 ， 那 么 可 能 就 需要 另 起 一 个 线程 不 断 地 循环 调用 重 绘画 
布 了 。 

在 按键 按 下 函数 中 添加 重 绘 函 数 : 


@Override 
Public boolean onKeyDown (int keyCode, KeyEvent event) { 


invalidate(); 
//postIinvalidate(); 
return super.onKeyDown (keyCode, event); 


这 两 种 重 绘 函 数 ， 开 发 人 员 可 以 按 自己 的 喜好 选择 。 

到 此 为 止 ， 让 一 个 文本 通过 方向 按键 移动 的 效果 就 真正 的 完成 了 。 这 个 过 程 貌 似 很 复 
杂 ， 其 实 是 很 简单 的 ， 为 了 让 大 家 更 加 深刻 地 理解 ， 讲 解 的 内 容 稍微 会 偏 多 一 点 ; 希望 大 家 
学 习 到 此 ， 自 己 动手 练习 一 下 ， 熟 悉 相关 的 过 程 和 细节 。 

运行 项 目 ， 效 果 如 图 4-7 所 示 。 


按 下 手机 方向 按键 的 “ 右 方向 键 ” 
绘制 的 文本 仁 置 发 生 了 改变 ; 


图 4-7 按键 监听 


按键 监听 除了 onKeyDown 还 有 onKeyUp， 两 种 监听 区 别 在 于 事件 的 状态 ， 一 个 是 按 
下 ， 一 个 是 抬 起 ， 其 按键 键 值 的 匹配 方法 都 是 一 样 的 ， 那 么 到 底 使 用 哪 种 按键 监听 ， 就 需要 
根据 实际 的 项 目 来 选择 了 。 

这 里 需要 提醒 的 一 点 是 ， 当 前 在 做 的 是 让 绘制 的 文本 移动 的 效果 ， 其 实 它 是 个 动态 的 效 
果 ， 在 本 章 开 始 的 时 候 就 解释 过 ， 动 态 效果 有 两 种 方式 实现 : 

® 不断 的 绘制 新 的 画布 ; 

@ 使 用 一 张 画布 ， 通 过 刷 屏 来 让 这 张 画布 恢复 到 初始 空白 画布 的 状态 ， 然 后 再 向 画布 上 

进行 绘制 。 


本 小 节 通 过 调用 View 类 提供 的 重 绘 函数 来 实现 文本 的 动态 效果 ， 那 么 View 封装 的 这 两 
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种 重 绘 函数 ， 底 层 实现 到 底 是 重新 在 新 的 画布 上 绘制 ， 还 是 利用 刷 屏 来 实现 的 ， 有 兴趣 的 朋 
友 可 以 下 载 Android 的 SDK 源码 研究 一 下 。 这 里 需要 记 住 的 是 ， 不 管 Android 是 通过 哪 种 方 
式 封 装 的 重 绘 函数 ， 只 要 知道 使 用 了 重 绘 函数 就 不 要 再 去 做 刷 屏 操作 即 可 。 至 于 如 何 用 代码 
实现 刷 屏 ， 将 会 在 后 续 讲解 SurfaceView 游戏 框架 时 详细 为 大 家 介绍 。 


4.4.3 ” 触 屏 监听 


上 一 小 节 利用 按键 监听 实现 了 文本 的 移动 ， 本 小 节 将 利用 触 屏 监听 函数 来 实现 让 文本 跟 
随 玩 家 手指 在 屏幕 的 位 置 移动 。 仔 细 分 析 一 下 ， 让 文本 跟随 手指 移动 ， 无 疑 有 两 种 情况 ; 


e@ 手指 点 击 屏幕 时 ， 文 本 的 X、Y 坐标 要 在 手指 相对 于 屏幕 的 位 置 ; 
@ 手指 在 屏幕 上 滑动 ， 文 本 的 X、Y 坐标 跟随 手指 在 屏幕 的 位 置 移动 。 


其 实 不 管 哪 种 情况 ， 总 结 一 句 来 说 就 是 : 文本 的 坐标 永远 是 玩家 手指 在 手机 屏幕 上 的 位 
置 ! 


为 了 实现 文本 跟随 手指 移动 的 效果 ， 我 们 在 触 屏 监听 函数 中 添加 代码 如 下 : 


QOverride 
Public boolean onTouchEvent (MotionEvent event) { 
int x = (int)event.getx(); 
int y = (int)event.getYy(); 
// 玩 家 手指 点 击 屏幕 的 动作 
if (event.getAction() == MotionEvent .ACTION DOWN) { 
textX = x; 
textY = y; 
// 玩 家 手指 抬 起 离开 屏幕 的 动作 
} else if (event.getAction() 一 MotionEvent .ACTION MOVE) { 
textX = x; 
textY = y; 
// 玩 家 手指 在 屏幕 上 移动 的 动作 
} else if (event.getAction() 一 MotionEvent .ACTION UP) { 
textX = x? 
textY = Y7 


ji 
// 重 绘画 布 
invalidate(); 


//postIinvalidate(); 
return super.onTouchEvent (event); 


在 上 面 代码 中 使 用 了 触 屏 事件 监听 函数 : 


Public boolean onTouchEvent (MotionEvent event) {} 
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触 屏 监听 函数 只 有 一 个 参数 MotionEvent event。 此 类 实例 中 保存 了 玩家 触 屏 的 动作 ， 比 
如 常见 的 动作 有 : 按 下 动作 、 抬 起 动作 、 移 动 动作 、 屏 幕 压 力 、 多 点 触 屏 等 等 ， 当 然 此 类 中 
也 定义 了 很 多 动作 的 静态 常量 值 。 通 过 event.getAction() 方 法 获取 玩家 的 动作 与 所 需 动作 常量 
值 匹配 。 

运行 项 目 ， 使 用 手指 点 击 屏幕 、 离 开 屏 幕 都 很 正常 ， 但 是 当 手指 在 屏幕 中 进行 滑动 的 时 
候 ， 文 本 坐标 并 没有 跟随 手指 移动 ， 也 就 是 说 MotionEvent.4CTION_MOVE 的 动作 ， 系 统 获 
取 不 到 。 这 里 简单 解释 一 下 原因 : onTouchEventO 函数 通常 情况 下 会 去 执行 
super.onTouchEvent() 函 数 并 传 回 布尔 值 。 但 是 super.onTouchEvent() 中 的 super 会 有 可 能 并 没 
做 任何 事 ， 并 且 回 传 false 回来 。 一 旦 回 传 false 回来 ， 后 面 的 event 动 作 可 能 就 会 收 不 到 了 ， 
所 以 为 了 确保 后 面 的 event 能 顺利 收 到 ， 应 该 让 触 屏 监听 函数 的 返回 值 永远 为 tue。 因 此 ， 修 
改 触 屏 监听 函数 如 下 : 


QOverride 
Public boolean onTouchEvent (MotionEvent event) { 


return true; 
} 


针对 当前 做 的 文本 跟随 用 户 手指 的 功能 ， 在 触 屏 监听 函数 中 ， 其 实 没有 必要 获取 用 户 的 
动作 ， 因 为 不 管用 户 是 什么 动作 ， 开 发 人 员 需 要 的 只 是 用 户 手 指 触摸 在 屏幕 上 的 X、Y 坐标 
位 置 ， 所 以 修改 以 将 触 屏 监听 函数 简化 : 


QOverride 

Public boolean onTouchEvent (MotionEvent event) { 
// 获 取 用 户 手指 触 屏 的 X 坐标 赋值 与 文本 的 X 坐标 
textX = (int)event .getX() 
// 获 取 用 户 手指 触 屏 的 Y 坐标 赋值 与 文本 的 Y 坐标 
textY = (int)event .getY(); 
// 重 绘画 布 
invalidate(); 
//postInvalidate (); 
return true; 


其 实 View 中 触 屏 监 听 函 数 也 对 应 有 一 个 设置 触 屏 焦点 的 函数 : 
setFocusableInTouchMode (true); 

但 是 默认 不 用 设置 ， 触 屏 监 听 函 数 也 能 正常 响应 。 

到 此 为 止 ， 对 View 视图 的 按键 监听 、 触 屏 监听 、 绘 制 函 数 、 重 绘 函 数 、 画 布 的 绘制 等 


都 做 了 相应 的 解释 和 说 明 。 其 实在 游戏 开发 中 需要 系统 支持 的 无 非 就 是 这 些 函 数 了 ， 所 以 在 
Android 的 View 视图 中 进行 游戏 开发 基本 就 讲解 完了 ， 至 此 ， 整 个 View 的 游戏 框架 也 就 介 
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绍 完毕 了 。 至 于 如 何在 画布 中 绘制 图 形 、 图 片 ， 以 及 设置 画笔 属性 等 内 容 将 在 讲述 完 
SurfaceView 游戏 框架 后 再 进行 详细 的 讲解 。 


4 5 SurfaceView 游戏 框架 


上 一 节 讲 解 了 View 游戏 框架 ， 本 节 将 继续 讲解 SurfaceView 游戏 框架 。 


4.5.1 ”SurfaceView 游戏 框架 实例 


新 建 项 目 “GameSurfaceView”， 如 图 4-8 所 示 。 本 项 目 对 应 的 源 代码 为 “4-4 
(SurfaceView 游戏 框架 ) ”。 


圈 New Android Project Ee 
New Android Project 4 
Creates a new Android Project resource. i! 


Project name: GameSurfaceView 


Contents 

Create new project in workspace 

© Create project from existing source 
回 Use default location 


scation: | G/Book/workspace/GameSurfaceView Browse 
© Create project from existing sample 


Samples: ApiDemos 


Build Target 
Target Name Vendor Platform 。 API .. 
加 Android 15 Android Open Source Project = 15 3 
回 GoogleApls Google Inc. 15 3 
国 Android 1.6 Android Open Source project = 16 4 


Standard Android platform 1.6 


properties 
Application name: GameSurfaceView 


Package name: com.gsf 
辐 Create Activity: MainActivity 
Min SDK Version: 


回 | | 


图 4-8 新 建 项 目 “GameSurfaceView” 
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首先 自 定义 一 个 类 “MySurfaceView ”， 此 类 继承 SurfaceView， 除 此 之 外 还 要 实现 
android.view.SurfaceHolder.Callback 接口 ， 代 码 如 下 : 


public class MySurfaceView extends SurfaceView implements Callback { 
// 用 于 控制 SurfaceView 
private SurfaceHolder sfh; 
Private Paint paint; 
public MySurfaceView (Context context) { 
super (context); 
// 实 例 SurfaceHolder 
sfh = this.getHolder (); 


// 为 SurfaceView 添加 状态 监听 
sfh.addCcallback (this); 
// 实 例 一 个 画笔 
paint = new Paint(); 
// 设 置 画笔 颜色 为 白色 
paint.setColor (Color .WHITE); 
} 
QOverride 
Public void surfaceCreated(SurfaceHolder holder) { 
myDraw (); 
. 
Q@Override 


Public void surfaceChanged(SurfaceHolder holder, int format, int 
width, int height) { 
1 
@Override 
Public void surfaceDestroyed(SurfaceHolder holder) { 
} 
/** 
* 自 定义 绘图 函数 
od 
Public void myDraw() { 
Canvas canvas = sfh.lockCanvas(); 
canvas .drawText ("Game", 10, 10, paint); 
sfh.unlockCanvasAndPost (canvas); 


在 上 面 程序 中 定义 了 一 个 SurfaceHolder 类 的 实例 ， 此 类 提供 控制 SurfaceView 的 大 小 、 
格式 等 ， 并 且 主 要 用 于 监听 SurfaceView 的 状态 。 其 实 SurfaceView 只 是 保存 当前 视图 的 像素 
数据 ， 在 使 用 SurfaceView 时 ， 并 不 会 与 SurfaceView 直接 打交道 ， 而 是 通过 SurfaceHolder 
来 控制 ， 使 用 SurfaceHolder 的 lockCanvas() 函 数 来 获取 到 SurfaceView 的 Canvas 对 象 ， 再 通 
过 在 Canvas 上 绘制 内 容 来 修改 SurfaceView 中 的 数据 。 

lockCanvas() 函 数 不 仅 是 获取 Canvas， 同 时 还 对 获取 的 Canvas 画布 进行 加 锁 ， 这 里 对 画 
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布 进行 同步 加 锁 的 机 制 主要 是 为 了 防止 SurfaceView 在 绘制 过 程 中 被 修改 、 摧 毁 等 发 生 的 状 
态 改 变 ; 与 lockCanvas() 函 数 对 应 的 还 有 一 个 unlockCanvasAndPost (Canvas canvas) 函数 用 
于 解锁 画布 和 提交 。 


SurfaceHolder 类 除了 lockCanvas() 函 数 可 以 获取 当前 视图 的 画布 (画布 默认 大 小 同 手 


机 屏幕 大 小 ) 外 ， 还 提供 一 个 lockCanvas (Rect rect ) 函数 ， 其 中 传 入 一 个 Rect 珑 形 类 的 
实例 ， 用 于 得 到 一 个 自 定 义 大 小 的 画布 。 


SurfaceHolder 对 SurfaceView 的 状态 进行 监听 需要 使 用 android.view.SurfaceHolder. 
Callback 接口 ， 此 接口 需 三 个 函数 ， 用 于 监听 SurfaceView 的 不 同 状态 : 
(1) 当 SurfaceView 被 创建 完成 后 响应 的 函数 
Q@Override 


public void surfaceCreated (SurfaceHolder holder) { 
} 


(2) 当 SurfaceView 状态 发 生 改 变 时 响应 的 函数 


QOverride 

public void surfaceChanged (SurfaceHolder holder, int format, int 
width, int height) { 

} 


(3) 当 SurfaceView 状态 摧毁 时 响应 的 函数 


@Override 
Public void surfaceDestroyed (SurfaceHolder holder) { 
上 


最 后 通过 SurfaceHolder 类 的 addCallback (CallBack callback) 函数 将 其 监听 接口 实例 传 
入 ， 可 完成 对 SurfaceView 的 状态 监听 。 

SurfaceView 是 View 的 子 类 ， 所 以 也 拥有 按键 监听 函数 、 触 屏 监听 函数 等 这 些 父 类 方 
法 ; 但 是 值 的 注意 的 是 因为 SurfaceView 是 通过 SurfaceHolder 来 修改 其 数据 ， 所 以 在 
SurfaceView 上 进行 绘制 不 再 使 用 onDraw (Canvas canvas) 来 绘图 ， 而 是 通过 SurfaceHolder 
获取 到 SurfaceView 的 Canvas， 然 后 再 进行 绘制 ， 所 以 即使 重 写 View 的 onDraw (Canvas 
canvas) 函数 ， 在 SurfaceView 启动 时 也 不 会 执行 到 。 

因此 ， 这 里 自 定 义 了 一 个 绘图 函数 : 
public void myDraw() { 


Canvas canvas = sfh.lockCanvas(); 
canvas.drawText ("Game", 10, 10, paint); 
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sfh.unlockCanvasAndPost (canvas); 


此 方法 通过 SurfaceHolder 的 lockCanvas() 函 数 得 到 一 个 Canvas 实例 ， 然 后 绘制 文本 ， 最 
后 解锁 并 提交 画布 。 接 下 来 ， 修 改 MainActivity 类 ， 让 其 显示 自 定义 的 SurfaceView 视图 : 


Public class MainActivity extends Activity { 
@Override 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
// 设 置 全 屏 
this.getWindow () .setFlags (WindowManager.LayoutParams .FLAG FULLSCR 
EEN, WindowManager.LayoutParams.FLAG FULLSCREEN); 
requestWindowFeature (Window.FEATURE NO_ TITLE); 
// 显 示 自 定义 的 SurfaceView 视图 
setContentView (new MySurfaceView (this)); 


最 后 运行 项 目 ， 效 果 如 图 4-9 所 示 。 


Game 


图 4-9 SurfaceView 视图 


运行 项 目 后 发 现 SurfaceView 视图 正常 显示 ， 那 么 下 面 来 实现 在 讲解 View 游戏 框架 时 的 
-个 小 功能 “让 文本 “Game” 跟 随 玩家 触 屏 的 手指 移动 ”。 
首先 定义 文本 的 坐标 为 成 员 变量 : 


Private int textX=10,textY=10; 


然后 修改 绘制 函数 : 


public void myDraw() { 
Canvas canvas = sfh.lockCanvas(); 
canvas.drawText ("Game", textX, textY, paint); 
sfh.unlockCanvasAndPost (canvas); 
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} 


最 后 完成 触 屏 监听 ( 重 写 View 的 触 屏 监听 函数 ): 


@Override 


Public boolean onTouchEvent (MotionEvent event) { 


textX = (int) event.getX(); 
textY = (int) event.getY(); 


myDraw (); 
return true; 


触 屏 事件 中 的 代码 ， 用 于 获取 当前 玩家 触 屏 的 坐标 赋值 与 文本 的 坐标 ， 最 后 调用 绘图 函 


数 myDraw(0) 函 数 来 重 


运行 项 目 ， 效 果 如 图 4-10 所 示 。 


Game ”Game 


Game 


Game Game 


Re _ 
Gal Ge 6 
Game sme 


Game 


Game 


Game _ 
Game 


通过 图 4-10 所 示 的 效果 图 来 看 ， 用 户 手指 在 屏幕 中 滑动 后 视 
介绍 View 游戏 框架 完成 这 个 “文本 跟随 玩家 手指 移动 ”的 小 功能 时 ， 对 屏幕 的 


图 4-10 画布 截图 


图 显示 简直 就 是 一 团 糟 。 在 


E 绘 都 是 使 


用 了 View 提供 的 重 绘 函数 进行 的 ， 因 为 使 用 View 的 两 种 重 绘 函数 后 ， 会 默认 重新 调用 
View 的 onDraw 函数 。 那 么 ， 既 然 在 触 屏 事 件 中 也 调用 了 自 定义 的 绘图 函数 ， 为 什么 这 里 就 


出 现 问题 了 呢 ? 


仔细 观察 图 4-10 也 不 难看 出 ， 画 布 肯定 更 新 到 了 最 新 的 状态 ， 和 否则 文本 的 最 新 位 置 不 会 
显示 ， 但 是 没有 显示 正常 的 效果 ， 视 图 中 应 该 是 只 存在 一 个 “Game” 的 文本 字样 ， 其 原因 是 
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画布 没有 刷新 ， 将 每 次 绘制 的 文本 全 部 都 显示 了 出 来 。 解 决 方法 就 是 对 画布 进行 “ 刷 屏 ”。 


4.5.2 ” 刷 屏 的 方式 


在 之 前 使 用 View 视图 时 并 没有 手动 “ 刷 屏 ”， 其 原因 也 解释 过 ， 是 因为 View 类 本 身 提 
供 的 两 种 重 绘 函 数 ， 其 内 部 已 经 封装 了 对 画布 的 刷 屏 操作 (也 可 能 每 次 都 绘制 在 一 个 新 的 画 
布 上 ) ， 所 以 每 次 在 onDraw〈Canvas canvas) 中 重 绘画 布 永远 看 不 到 之 前 绘制 过 的 图 形 。 
但 是 ， 在 当前 使 用 的 SurfaceView 是 自 定义 的 绘图 函数 ， 而 且 每 次 获取 到 的 Canvas 仍然 
是 上 次 使 用 过 的 画布 。 系 统 没有 刷新 画布 ， 也 没有 重新 提供 一 张 画布 ， 我 们 在 每 次 绘制 之 前 
也 没 进行 刷 屏 ， 这 样 相当 于 我 们 不 断 地 在 一 张 画布 上 进行 绘图 ， 必 然 会 遗留 下 以 前 画布 的 状 

所 以 ， 使 用 SurfaceView 视图 时 ， 在 得 到 其 画布 Canvas 之 后 ， 首 先进 行 的 应 该 是 刷 屏 操 
作 ， 将 画布 上 绘制 的 图 形 全 部 清空 ， 然 后 再 进行 绘图 。 

刷 屏 的 方式 有 以 下 几 种 : 

(1) 每 次 绘图 之 前 ， 绘 制 一 个 等 同 于 屏幕 大 小 的 图 形 覆 盖 在 画布 上 。 

修改 绘图 函数 如 下 : 


public void myDraw() { 
Canvas canvas = sfh.lockCanvas(); 
// 绘 制 矩形 (画笔 默认 为 填充 ) 
canvas.drawRect (0,0,this.getWwidth(),this.getHeight(), paint); 
canvas.drawText ("Game", textX, textY, paint); 
sfh.unlockCanvasAndPost (canvas); 


设置 画笔 为 填充 样式 ， 画 笔 默 认 绘制 图 形 不 填充 ， 

这 样 每 次 在 画布 上 绘图 前 都 绘制 一 个 填充 的 ， 大 小 等 同 于 屏幕 的 矩形 覆盖 画布 ， 只 要 这 
个 矩形 的 颜色 等 同 于 屏幕 默认 的 颜色 ， 那 就 等 同 于 将 屏幕 做 了 清空 操作 。 

(2) 每 次 绘图 之 前 ， 在 画布 上 填充 一 种 颜色 。 

修改 绘图 函数 如 下 : 


public void myDraw() { 
Canvas canvas = sfh.lockCanvas(); 
canvas.drawColor (Color. BLACK); 
canvas.drawText ("Game", textX, textY, paint); 
sfh.unlockCanvasAndPost (canvas); 


Canvas 类 中 的 drawColor(int color) 函 数 是 往 整个 画布 中 填充 一 种 颜色 。 
(3) 每 次 绘图 之 前 ， 指 定 RGB 来 填充 画布 。 
修改 绘图 函数 如 下 : 
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public void myDraw() { 
Canvas canvas = sfh.lockCanvas(); 
canvas.drawRGB (0, 0, 0); 
canvas.drawText ("Game", textX, textY, paint); 
sfh.unlockCanvasAndPost (canvas); 


Canvas 类 中 的 drawRGB (int rint g,int b) 函数 是 指定 一 种 颜色 对 屏幕 进行 填充 ， 其 方法 
的 三 个 参数 分 别 是 红色 、 绿 色 、 蓝 色 组 合 而 成 的 颜色 的 分 量 ， 当 三 个 值 都 为 0 时 ， 就 是 黑 
色 ; 三 个 值 都 是 255 时 ， 就 是 白色 。 

(4) 每 次 绘图 之 前 ， 绘 制 一 张 等 同 于 屏幕 大 小 的 图 片 覆 盖 在 画布 上 。 

很 多 游戏 都 会 有 背景 图 ， 所 以 每 次 在 画布 上 绘制 ， 首 先 绘制 背景 图 即 可 ， 但 是 这 张 背景 
图 一 定 要 等 同 于 屏幕 的 大 小 ， 否 则 屏幕 部 分 区 域 肯定 还 会 看 到 以 前 绘图 的 遗迹 。 

其 实 以 上 的 四 种 刷 屏 方式 虽然 使 用 的 方法 不 一 ， 但 是 原理 都 一 样 ， 就 是 每 次 在 画布 绘制 
之 前 都 对 画布 进行 一 次 整体 的 覆盖 。 


4.5.3 ”SurfaceView 视图 添加 线程 


在 游戏 中 ， 基 本 上 不 会 等 用 户 每 次 触发 了 按键 事件 、 触 屏 事 件 才 去 重 绘 画布 ， 而 是 会 固 
定 一 个 时 间 去 刷新 画布 ， 比 如 游戏 中 的 倒计时 、 动 态 的 花草 、 流 水 等 等 ， 这 些 游戏 元 素 并 不 
会 跟 玩 家 交互 ， 但 是 这 些 元 素 却 都 是 动态 的 。 所 以 游戏 开发 中 ， 都 会 有 一 个 线程 不 停 的 去 重 
绘画 布 ， 实 时 的 更 新 游戏 元 素 的 状态 。 

当然 游戏 中 除了 画布 给 玩家 最 直接 的 动态 展现 外 ， 也 会 有 很 多 逻辑 需要 不 间断 地 去 更 
新 ， 比 如 怪物 的 AI (人 工 智能 ) 、 游 戏 中 钱币 的 更 新 等 等 。 

下 面 就 为 本 节 实 例 项 目 中 的 SurfaceView 视图 添加 线程 ， 用 于 不 停 的 重 绘画 布 以 及 不 停 
地 执行 游戏 逻辑 。 完 整 的 SurfaceView 游戏 框架 中 的 自 定义 视图 MySurfaceView 类 代码 如 
下 : 


public class MySurfaceView extends SurfaceView implements Callback, 
Runnable { 

// 用 于 控制 SurfaceView 

private SurfaceHolder sfh; 

// 声 明 一 个 画笔 

Private Paint paint; 

// 文 本 的 坐标 

Private int textX = 10，textY = 10; 

// 声 明 一 条 线程 

Private Thread th; 

// 线 程 消亡 的 标识 位 

Private boolean flag; 

// 声 明 一 个 画布 
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Private Canvas canvas; 
// 声 明 屏幕 的 宽 高 
Private int screenW, screenH; 
/** 
* SurfaceView 初始 化 函数 
hd 
Pub1lic MySurfaceView (Context context) { 
super (context); 
// 实 例 SurfaceHolder 
sfh = this.getHolder (); 
// 为 SurfaceView 添加 状态 监听 
sfh.addCallback (this); 


// 实 例 一 个 画笔 
paint = new Paint(); 
// 设 置 画 笔 颜 色 为 白色 
paint.setColor (Color .WHITE); 
// 设 置 焦点 
setFocusable (true); 
了 
/** 
* SurfaceView 视图 创建 ， 响 应 此 函数 
SA 
Q@Override 


Public void surfaceCreated(SurfaceHolder holder) 
screenW = this.getWwidth(); 
screenH = this.getHeight (); 


flag = true; 
// 实 例 线程 
th = new Thread (this); 
// 启 动 线程 
th.start() 
由 
/** 
* 游戏 绘图 
ek 
Public void myDraw() { 
try { 
canvas = sfh.lockCanvas (); 
if (canvas != null) { 
WO 利用 绘制 矩形 的 方式 ， 
//// 绘 制 矩形 
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刷 屏 


//canvas.drawRect (0,0,this.getwidth(), 


//this.getHeight (), paint); 
人 利用 填充 画布 ， 刷 屏 


Canvas.drawColor (Color.BLRCK) ; 


J 利用 填充 画布 指定 的 颜色 分 量 ， 刷 屏 
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canvas.drawRGB (0, 0, 0); 


canvas.drawText ("Game", textX, textY, paint); 


D 
} catch (Exception e) { 
// TODO: handle exception 


} finally { 
if (canvas != null) 
sfh.unlockCanvasAndPost (canvas); 
} 
} 
/** 
* 触 屏 事件 监听 
bd 
Q@Override 


Public boolean onTouchEvent (MotionEvent event) { 
textX = (int) event.getx(); 
textY = (int) event.getYy (); 
return true; 
| 
/** 
* 按键 事件 监听 
EW 
@Override 
Public boolean onKeyDown (int keyCode, KeyEvent event) { 
return super.onKeyDown (keyCode, event); 
’; 
/** 
* 游戏 逻辑 
pd 
Private void logic() { 
l!: 
@Override 
Public void run() { 
while (flag) { 
long start = System.currentTimeMillis(); 
myDraw (); 
logic(); 
long end = System.currentTimeMillis(); 
try { 
4£ (end - Start < 50) { 


Thread. sleep(50 - (end - start)); 


} 
} catch (InterruptedException e) { 
e.printSstackTrace (); 
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} 
/** 
* SurfaceView 视图 状态 发 生 改 变 ， 响 应 此 函数 
六 
QOverride 
public void surfaceChanged(SurfaceHolder holder, int format, int 
width, int height) { 
} 
/** 
* SurfaceView 视图 消亡 时 ， 响 应 此 函数 
nt 
QOverride 
public void surfaceDestroyed(SurfaceHolder holder) { 
flag = false; 
上. 


本 类 中 有 很 多 需要 注意 的 地 方 ， 按 照 代码 由 上 到 下 的 顺序 详解 说 明 : 

(1) 线程 标识 位 

在 代码 中 “boolean flag;” 语 句 声明 一 个 布尔 值 ， 它 主要 用 于 以 下 两 点 : 

@ 便 于 消亡 线程 

大 家 都 知道 一 个 线程 一 旦 启动 ， 就 会 执行 其 run0 函 数 ，run0 函 数 执 行 结束 后 ， 线 程 也 伴 
随 着 消亡 。 由 于 游戏 开发 中 使 用 的 线程 一 般 都 会 在 run() 函 数 中 使 用 一 个 while 死 循 环 ， 在 这 
个 循环 中 会 调用 绘图 和 风 辑 函数 ， 使 得 不 断 的 刷新 画布 和 更 新 逻辑 ， 那 么 如 果 游 戏 暂 停 或 者 
游戏 结束 时 ， 为 了 便于 销毁 线程 在 此 设置 一 个 标识 位 来 控制 。 

@ 防 止 重复 创建 线程 及 程序 异常 

为 什么 会 重复 创建 线程 ， 首 先 从 Android 系统 的 手机 说 起 。 熟 悉 或 者 接触 过 Android 系 
统 的 人 都 知道 ，Android 手机 上 一 般 都 会 有 “Back (返回 ) ”与 “Home (小 房子 ) ”按键 ; 
不 管 当前 手机 运行 了 什么 程序 ， 只 要 单 击 “Back” 或 者 “Home” 按 键 的 时 候 ， 默 认 会 将 当前 
的 程序 切入 到 系统 后 台 运行 〈 程 序 中 没有 截获 这 两 个 按钮 的 前 提 下 ) ; 也 正 因为 如 此 ， 会 造 
成 SurfaceView 视图 的 状态 发 生 改 变 。 下 面 来 讲解 这 两 个 按钮 按 下 以 及 重新 回 到 程序 时 ， 
SurfaceView 都 执行 到 了 哪些 函数 。 

首先 单 击 “Back ”按钮 使 当前 程序 切入 后 台 ， 然 后 单 击 项 目 重 新 回 到 程序 中 ， 
SurfaceView 的 状态 变化 为 :surfaceDestroyed 一 构造 函数 一 surfaceCreated 一 surfaceChanged。 

然后 单 击 “Home” 按 钮 使 当前 程序 切入 后 台 ， 单 击 项 目 重新 回 到 程序 中 ，SurfaceView 
的 状态 变化 为 : surfaceDestroyed 一 surfaceCreated 一 surfaceChanged。 

通过 SurfaceView 的 状态 变化 可 以 明显 看 到 ， 当 点 击 “Back” 按 键 并 重新 进入 程序 的 过 
程 要 比 点 击 “Home” 按 键 多 执行 了 一 个 构造 函数 。 也 就 是 说 ， 当 点 击 “Back” 返 回 按键 时 ， 
SurfaceView 视图 会 被 重新 加 载 。 
正 因为 这 个 原因 ， 如 果 线 程 的 初始 化 是 在 视图 构造 函数 或 者 在 视图 构造 函数 之 前 ， 那 么 
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线程 启动 也 要 放 在 视图 构造 函数 中 进行 。 

千 万 不 要 把 线程 的 初始 化 放 在 surfaceCreated 视图 创建 函数 之 前 ， 而 线程 的 启动 却 放 在 
surfaceCreated 视图 创建 的 函数 中 ， 和 否则 程序 一 旦 被 玩家 点 击 “Home” 按 键 后 再 重新 回 到 游 
戏 时 ， 程 序 会 抛 出 异常 ， 异 常 信息 如 下 : 


java. lang.IllegalThreadStateException: Thread already started. 
at java.lang.Thread.start (Thread .java:1286) 
at com.gsf .MySurfaceView.surfaceCreated(MySurfaceView. java:62) 
at android.view.SurfaceView.updateWindow(SurfaceView. java:392) 
at android.view.SurfaceView.onWindowVisibilityChanged(SurfaceView. java;182) 
at android.view.View.dispatchWindowVisibilityChanged(View.java:3745) 
at android.view. ViewGroup.dispatchWindowVisibilityChanged(ViewGroup. java:690) 
at android ,view. ViewGroup.dispatchWindowVisibilityChanged(ViewGroup. java;690) 
at android.view. ViewRoot .performTraversals(ViewRoot .java:694) 
at android.view. ViewRoot .handleMessage(ViewRoot .java:1613) 
at android.os.Handler .dispatchMessage(Handler .java:99) 
at android.os.Looper.1loop(Looper .java:123) 
at android.app. ActivityThread .main(ActivityThread java; 4203) 
at java.lang.reflect.Method,invokeNative(Native Method) 
at java.lang.reflect .Method.invoke(Method, java:521) 
at com.android.internal .os,ZygoteInit$MethodAndArgsCaller ,run(ZygoteInit ,java:791) 
at com .android.internal.os.ZygoteInit .main(ZygoteInit .java:549) 
at dalvik.systen. NativeStart .main(Native Method) 


异常 是 因为 线程 已 经 启动 造成 的 ， 原 因 很 简单 ， 因 为 程序 被 “Home” 键 切入 后 台 再 从 后 
台 恢 复 时 ， 会 直接 进入 surfaceCreated 视图 创建 函数 中 ， 又 执行 了 一 遍 线程 启动 ! 

能 够 想到 的 解决 方法 是 ， 可 以 将 线程 的 初始 化 和 启动 都 放 在 视图 的 构造 函数 中 ， 或 者 都 
放 在 视图 创建 的 函数 中 。 但 是 这 里 又 出 现 新 的 问题 ， 如 果 将 线程 的 初始 化 和 启动 都 放 在 视图 
的 构造 函数 中 ， 那 么 当 程序 被 “Back” 键 切入 后 台 再 从 后 台 恢 复 时 ， 线 程 的 数量 会 增多 ， 反 
复 多 次 ， 就 会 反复 多 出 对 应 的 线程 。 

那么 ， 大 家 可 能 又 会 想到 将 flag 这 个 线程 标识 位 在 视图 摧毁 时 让 其 值 改 为 false， 从 而 使 
当前 这 个 线程 的 run 方 执行 完毕 ， 以 达到 摧毁 掉 线 程 的 目的 。 不 幸 的 是 ， 这 也 是 错误 的 做 
法 

大 家 可 以 想 想 ， 即 使 在 视图 销毁 时 利用 flag 标识 位 摧毁 游戏 线程 ， 但 是 如 果 点 击 
“Home” 按 键 呢 ?” 当 程序 恢复 的 时 候 ， 程 序 就 不 执行 线程 了 ， 也 就 是 说 重 绘 和 逻辑 函数 都 不 
再 执行 ! 

所 以 最 完美 的 做 法 就 是 ， 线 程 的 初始 化 与 线程 的 启动 都 写 在 视图 的 surfaceCreated 创建 函 
数 中 ， 并 且 将 线程 标识 位 在 视图 摧毁 时 将 其 值 改 变 为 false。 这 样 既 可 以 避免 “线程 已 启动 ” 
的 异常 ， 还 可 以 避免 点 击 Back 按键 无 限 增加 线程 数 的 问题 。 

(2) 获取 视图 的 宽 和 高 

在 SurfaceView 视图 中 获取 视图 的 宽 和 高 的 方法 : 


e this.getWidth(): 获取 视图 宽度 。 
e this.getHeight(): 获取 视图 高 度 。 


140 


第 4 章 ”游戏 开发 基础 


在 SurfaceView 视图 中 获取 视图 的 宽 高 ， 一 定 要 在 视图 创建 之 后 才 可 获取 到 ， 也 就 是 


在 surfaceCreated 函数 之 后 获取 ， 在 此 函数 执行 之 前 获取 到 的 永远 是 零 ， 因 为 当前 视图 还 
没有 创建 ， 是 没有 宽 高 值 的 。 


(3) 绘图 函数 try 一 下 

因为 当 SurfaceView 不 可 编辑 或 尚未 创建 时 ， 调 用 lockCanvas0) 函 数 会 返回 null; Canvas 
进行 绘图 时 也 会 出 现 不 可 预知 的 问题 ， 所 以 要 对 绘制 函数 中 进行 try...catch 处 理 ， 既 然 
lockCanvas() 函 数 有 可 能 获取 为 null， 那 么 为 了 避免 其 他 使 用 canvas 实例 进行 绘制 的 函数 报 
错 ， 在 使 用 Canvas 开始 绘制 时 ， 需 要 对 其 进行 判定 是 否 为 null。 

(4) 提交 画布 必须 放 在 finally 中 

绘图 的 时 候 可 能 会 出 现 不 可 预知 的 Bug， 虽 然 使 用 try 语句 包 起 来 了 ， 不 会 导致 程序 崩 
省 ;， 但 是 一 旦 在 提交 画布 之 前 出 错 ， 那 么 解锁 提交 画布 函数 则 无 法 被 执行 到 ， 这 样 会 导致 下 
次 通过 lockCanvas() 来 获取 Canvas 时 程序 抛 出 异常 ， 原 因 是 因为 画布 上 次 没有 解锁 提交 ! 所 
以 画布 将 解锁 提交 的 函数 应 放 入 finally 语句 块 中 。 

还 要 注意 ， 虽 然 这 样 保证 了 每 次 能 正常 提交 解锁 画布 ， 但 是 提交 解锁 之 前 要 保证 画布 不 
为 空 的 前 提 ， 所 以 还 需 判断 Canvas 是 否 为 空 ， 这 样 一 来 就 完美 了 。 

(5) 刷 帧 时 间 尽 可 能 保证 一 至 

虽然 在 线程 循环 中 ， 设 置 了 休眠 时 间 ， 但 是 这 样 并 不 完善 ! 比如 在 当前 项 目 中 ，run 的 
while 循环 中 除了 调用 绘图 函数 还 一 直 调 用 处 理 游戏 逻辑 的 logic() 函 数 ， 虽 然 在 当前 项 目的 逻 
辑 函 数 中 并 没有 写 任何 的 代码 ， 但 是 假设 这 个 逻辑 函数 logic0 中 写 了 几 千 行 的 逻辑 ， 那 么 系 
统 在 处 理 罗 和 辑 时 ， 时 间 的 开销 是 否 与 上 次 的 相同 ， 这 是 无 法 预料 的 ， 但 是 可 以 尽 可 能 地 让 其 
时 间 差 值 趋 于 相同 。 假 设 游戏 线程 的 休眠 时 间 为 X 毫秒， 一 般 线程 的 休眠 写法 为 : 


Thread. sleep (X); 
优化 写法 步骤 如 下 : 
要 于》 首先 通过 系统 函数 获取 到 一 个 时 间 戳 : 


long start = System.currentTimeMillis(); 


// 在 线程 中 的 绘图 、 逻 辑 等 的 函数 

到 3》 处理 以 上 所 有 函数 之 后 ， 再 次 通过 系统 函数 获取 到 一 个 时 间 戳 : 

long end = System.currentTimeMillis(); 

全 王政 通过 这 两 个 时 间 戳 的 差 值 ， 就 可 以 知道 这 些 函数 所 消耗 的 时 间 : 如 果 ( end - start ) 
>X， 那 线程 就 完全 没有 必要 去 休眠 ; 如 果 ( end - start ) <X， 那 线程 的 休眠 时 间 应 
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该 为 X- ( end 一 start) 。 


线程 休眠 应 更 改 为 以 下 写法 : 


if((end - start)<Xx){ 
Thread. sleep(X- (end - start)); 
} 


- 般 游戏 中 刷新 时 间 在 50~100 毫秒 之 间 ， 也 就 是 每 秒 10~20 帧 左右 ， 当 然 还 要 视 具体 情 
况 和 项 目 而 定 。 


4. 6 View 与 SurfaceView 的 区 别 


在 Android 2D 游戏 开发 中 ， 可 以 选用 View 与 SrufaceView 这 两 种 视图 进行 开发 ， 前 面 简 
单 的 讲解 了 View 和 SurfaceView 游戏 框架 后 ， 本 节 就 来 总 结 一 下 两 者 的 区 别 和 特点 ， 从 而 让 
大 家 在 开发 游戏 前 根据 游戏 的 类 型 来 选择 合适 的 视图 。 

1 . 更 新 画布 

在 View 视图 中 对 于 画布 的 重新 绘制 ， 是 通过 调用 View 提供 的 postInvalidate() 与 
invalidate(0) 这 两 个 函数 来 执行 的 ， 也 就 是 说 画布 是 由 系统 主 UI 进行 更 新 。 那 么 当 系 统 主 UI 
线程 更 新 画布 时 可 能 会 引发 一 些 问题 ; 比如 更 新 画面 的 时 间 一 旦 过 长 ， 就 会 造成 主 UI 线程 
被 绘制 函数 阻塞 ， 这 样 一 来 则 会 引发 无 法 响应 按键 、 触 屏 等 消息 的 问题 。 

SurfaceView 视图 中 对 于 画布 的 重 绘 是 由 一 个 新 的 单独 线程 去 执行 处 理 ， 所 以 不 会 出 现 因 
主 UI 线程 阻塞 而 导致 无 法 响应 按键 、 触 屏 信息 等 问题 。 


2 . 视图 机 制 


Android 中 的 View 视图 是 没有 双 缓 冲 机 制 的 ， 而 SurfaceView 视图 却 有 ! 也 可 以 简单 理 
解 为 ，SurfaceView 视图 就 是 一 个 由 View 扩展 出 来 的 更 加 适合 游戏 开发 的 视图 类 。 

简单 介绍 了 这 两 点 区 别 ， 貌 似 都 在 说 SurfaceView 视图 的 好 ， 其 实 不 然 ， 因 为 View 与 
SurfaceView 都 各 有 其 优点 ; 比如 一 款 棋牌 类 的 游戏 ， 此 类 型 游戏 画面 的 更 新 属于 被 动 更 新 ; 
因为 画布 的 重 绘 主要 是 依赖 于 按键 与 触 屏 事 件 〈( 当 玩家 有 了 操作 之 后 画布 才 需 要 进行 更 
新 ) ， 所 以 此 类 游戏 选择 View 视图 进行 开发 比较 合适 ， 而 且 也 减少 了 因 使 用 SurfaceView 需 
单独 起 一 个 新 的 线程 来 不 断 更 新 画布 所 带 来 的 运行 开销 。 

但 如 果 是 主动 更 新 画布 的 游戏 类 型 ， 比 如 RPG、 飞 行 射击 等 类 型 的 游戏 中 ， 很 多 元 素 都 
是 动态 的 ， 需 要 不 断 重 绘 元 素 状态 ， 这 时 再 使 用 View 显然 就 不 合适 了 。 所 以 到 底 开发 游戏 
使 用 哪 种 视图 更 加 的 合适 ， 这 完全 取决 于 游戏 类 型 、 风 格 与 需求 。 

总 体 来 说 ，SurfaceView 更 加 适合 游戏 开发 ， 因 为 它 能 适应 更 多 游戏 类 型 ， 在 后 文 讲解 的 
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项 目 中 都 将 使 用 SurfaceView 游戏 框架 进行 开发 。 


@ 只 要 后 文中 提 到 “使 用 SurfaceView 游戏 框架 ” 则 表示 项 目 中 包含 两 个 类 : 

。 MainActivity.java: 用 于 设置 全 屏 ， 显 示 游戏 视图 

@ MySurfaceView.java: 自 定义 游戏 视图 类 ， 继 承 SurfaceView; 并 且 MySurfaceView 类 
中 包含 游戏 开发 常用 的 按键 、 触 屏 、 绘 图 、 逻 辑 等 函数 。 

@ 本 章 中 运行 项 目的 Android 模拟 器 在 没有 特别 声明 的 情况 下 ， 一 律 采用 如 图 4-1 所 示 
配置 参数 的 模拟 器 运行 项 目 。 


4 。 /7 Canvas 画布 


画布 类 Canvas 封装 了 图 形 与 图 片 绘制 等 内 容 ， 此 类 常用 的 函数 说 明 如 下 : 


YW drawColor (int color) 
作用 : 绘制 颜色 覆盖 画布 ， 常 用 于 刷 屏 
参数 :颜色 值 ， 也 可 用 十 六 进 制 形式 表示 (ARGB) 
M drawText (String text, float x, float y, Paint paint) 
作用 : 绘制 文本 字符 
第 一 个 参数 : 文本 内 容 
第 二 、 三 个 参数 : 文本 的 X，Y 坐标 
第 四 个 参数 : 画笔 实例 
M drawPoint (float x, float y Paint paint ) 
作用 : 绘制 像素 点 
第 一 、 二 个 参数 : 像素 的 X,Y 坐标 
第 三 个 参数 : 画笔 实例 
M drawPoints (float[] pts, Paint paint) 
作用 : 绘制 多 个 像素 点 
第 一 个 参数 : Float 数组 ， 数 组 中 放置 的 是 多 个 像素 点 的 X,Y 坐标 
第 二 个 参数 : 画笔 实例 
M drawLine (float startX, float startY, float stopX, float stopY, Paint paint ) 
作用 : 绘制 一 条 直线 
前 两 个 参数 : 起 始点 的 X,Y 坐标 
后 两 个 参数 : 终点 的 X,Y 坐标 
最 后 一 个 参数 : 画笔 实例 
M drawLines (float[] pts, Paint paint) 
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作用 : 绘制 多 条 直线 
第 一 个 参数 : Float 数组 ， 数 组 中 放置 的 是 多 个 直线 的 起 始点 与 终点 X，Y 坐标 
第 二 个 参数 ， 画笔 实例 
M drawRect (float left float top, float right, float bottom, Paint paint) 
作用 : 绘制 矩形 
第 一 、 二 个 参数 : 矩形 的 左上 角 X,Y 坐标 
第 三 、 四 个 参数 : 拢 形 的 右 下 角 X,Y 坐标 
第 五 个 参数 ， 画笔 实例 
M drawRect (Rectr, Paint paint) 
作用 : 绘制 矩形 
第 一 个 参数 : 和 拢 形 实例 
第 二 个 参数 ， 画笔 实例 
M drawRoundRect (RectF rect, float rx, float ry, Paint paint) 
作用 : 绘制 圆 角 和 矩形 
第 一 个 参数 : 拢 形 实例 
第 二 个 参数 : 圆 角 X 轴 的 半径 
第 三 个 参数 : 圆 角 立轴 的 半径 
第 四 个 参数 : 画笔 实例 
M drawCircle (float cx, float cy, float radius, Paint paint) 
作用 : 绘制 圆 形 
第 一 、 二 个 参数 : 圆 形 的 中 心 点 X,Y 坐标 
第 三 个 参数 : 圆 形 的 半径 
第 四 个 参数 :画笔 实例 
M drawArc (RectF oval, float startAngle, float sweepAngle, boolean useCenter, Paint paint) 
作用 : 绘制 弧 形 (扇形 ) 
第 一 个 参数 ， 和 矩形 实例 
第 二 个 参数 ， 弧 形 的 起 始 角 度 (默认 45” 为 图 形 的 起 始 角 度 0”) 
第 三 个 参数 ， 弧 形 的 终止 角度 
第 四 个 参数 ， 是 否 绘 制 中 心 点 ， 如 果 为 真 ， 起 始点 与 终止 点 都 会 分 别 连接 中 心 点 
从 而 形成 封闭 图 形 ; 如 果 为 假 ， 则 起 始点 直接 连接 终止 点 ， 从 而 形成 
封闭 图 形 ; 
第 五 个 参数 : 画笔 实例 
M drawOval (RectF oval, Paint paint) 
作用 : 绘制 椭圆 
第 一 个 参数 : 矩形 实例 
第 二 个 参数 : 画笔 实例 
M drawPath (Path path, Paint paint) 
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作用 : 绘制 指定 路 径 图 形 
第 一 个 参数 : 路 径 实 例 
第 二 个 参数 : 画笔 实例 
M drawTextOnPath (String text, Path path, float hOffset float vOffset, Paint paint) 
作用 : 将 文本 沿 着 指定 路 径 进行 绘制 
第 一 个 参数 : 文本 
第 二 个 参数 : 路 径 实例 
第 三 个 参数 : 文本 距离 绘制 起 点 的 距离 
第 四 个 参数 : 文本 距离 路 径 的 距离 
第 五 个 参数 : 画笔 实例 
这 些 函数 都 比较 容易 理解 ， 它 们 所 使 用 的 参数 中 需要 特别 介绍 的 是 Rect 与 Path 这 两 个 


ee Rect: 给 形 类 ， 利 用 两 个 点 的 坐标 从 而 确定 矩形 的 大 小 ; 


其 常用 的 构造 函数 为 : 

M Rect (float left, float top, float right, float bottom ) 

第 一 、 二 个 参数 表示 矩形 的 左上 角 坐 标 ; 

第 三 、 四 个 参数 表示 矩形 的 右 下 角 坐 标 。 

Android 中 还 提供 了 一 个 RectF 类 ，RectF 类 与 Rect 类 主要 的 区 别 是 长 度 单位 精确 度 不 
同 ，RectF 使 用 单 精 度 浮 点 数 ， 而 Rect 使 用 int 类 型 ， 在 使 用 Canvas 绘制 矩形 时 ， 可 以 直接 
传 入 矩形 的 四 个 参数 的 方式 ， 也 可 以 选择 传 入 一 个 矩形 实例 。 


e Path: 指定 绘制 的 路 径 ， 然 后 按照 其 路 径 的 路 线 依次 绘制 ， 组 合 任意 需要 的 图 形 。 


其 常用 函数 如 下 : 
M moveTo (float x, floaty) 
作用 : 设 定 路 径 的 起 始点 
两 个 参数 : 起 始点 的 坐标 
M lineTo (float x, float y) 
作用 : 以 上 次 的 终点 作为 起 点 ， 以 本 次 的 坐标 点 为 终点 ， 两 点 之 间 使 用 一 条 直线 连 
接 
两 个 参数 : 本 次 点 线 的 终点 位 置 
M close() 
作用 : 路 径 结 束 的 标识 ， 如 果 路 径 关 闭 前 的 点 不 是 起 点 ， 将 自动 连接 封闭 
以 上 的 moveTo、lineTo 与 close 三 个 函数 搭配 使 用 ， 路 径 起 点 与 终点 只 需要 设置 一 次 ， 
而 路 线 lineTo 则 可 以 设置 多 个 。 
M android.graphics.Path.quadTo (float xl, float yl, float x2, float y2) 
作用 : 绘制 贝 赛 尔 曲线 
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第 一 个 参数 :操作 点 的 x 坐标 
第 二 个 参数 :操作 点 的 y 坐标 
第 三 个 参数 : 结束 点 的 x 坐标 
第 四 个 参数 : 结束 点 的 y 坐 标 
以 上 这 个 函数 是 Android 实现 并 封装 好 的 贝 赛 尔 曲线 方法 ， 为 了 让 大 家 知道 如 何 使 用 ， 


对 应 的 也 编写 了 一 个 在 视图 中 绘制 贝 赛 尔 曲线 的 项 目 ， 这 里 不 进行 详细 讲解 了 ， 对 应 的 源 代 
码 为 “4-7-1( 贝 塞 尔 曲线 ) ”。 


等 ; 


addArc (RectF oval, float startAngle, float sweepAngle ) 
addOval ( RectF oval, Direction dir) 

addCircle (float x, float y, float radius, Direction dir ) 
addRect ( RectF rect, Direction dir) 

addRoundRect ( RectF rect, float[] radii, Direction dir) 


以 上 函数 都 是 在 添加 不 同 图 形 的 绘制 路 径 ， 比 如 添加 圆 形 路 径 、 和 矩形 路 径 、 椭 圆 路 径 等 
虽然 这 种 直接 添加 图 形 路 径 的 方法 相对 于 使 用 moveTo、lineTo 与 close 这 种 组 合 路 径 方 


法 大 大 减少 了 工作 量 ， 但 是 直接 添加 图 形 路 径 的 方法 并 没有 组 合 路 径 灵 活 ， 至 于 想 绘制 什么 
形状 的 图 形 ， 还 要 根据 具体 情况 来 做 择优 选择 。 


到 此 为 止 ， 对 于 Canvas 一 些 最 常用 的 函数 ， 都 已 经 做 了 解释 和 说 明 ， 下 面 就 通过 实例 代 


码 实现 来 观察 这 些 常 用 函数 的 显示 效果 。 


首先 新 建 项 目 “CanvasProject”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代 码 


为 “4-7-2 (Canvas 画布 ) ”。 修 改 MySurfaceView 类 的 绘图 函数 代码 如 下 : 


Public void myDraw() { 
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try { 
canvas = sfh.lockCanvas(); 
if (canvas != null) { 
//---- 利 用 填充 画布 ， 刷 屏 
canvas .drawColor (Color .BLACK); 


//---- 绘 制 文本 
canvas .drawText ("drawText", 10, 10, paint); 
//---- 绘 制 像素 点 


canvas.drawPoint (10, 20, paint); 
//---- 绘 制 多 个 像素 点 
canvas .drawPoints (new float[] { 10, 30, 30,30}, paint); 


//---- 绘 制 直 线 
canvas .drawLine (10, 40, 50, 40, paint); 
//---- 绘 制 多 条 直线 


canvas .drawLines (new float[] { 10, 50, 50, 50, 70, 50, 
TIL0 S50 } paintys 

//---- 绘 制 矩形 

canvas .drawRect (10, 60, 40, 100, paint); 
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//---- 绘 制 矩形 2 


Rect rect = new Rect(10, 110, 60, 130); 
canvas .drawRect (rect, paint); 

canvas .drawRect (rect, paint); 
//---- 绘 制 圆 角 和 矩形 

RectF rectF = new RectF(10, 140, 60, 170); 
canvas .drawRoundRect (rectF, 20, 20, paint); 


//---- 绘 制 圆 形 
canvas .drawCircle(20，200，20，Ppaint) ; 
//---- 绘 制 弧 形 


canvas .drawRrc (new RectEF (150，20，200，70) ，0，230， 
true, paint); 
//---- 绘 制 椭圆 
canvas .drawOval (new RectF(150, 80, 180, 100), paint); 
//---- 绘 制 指定 路 径 图 形 
Path path = new Path() 7 
// 设 置 路 径 起 点 
path.moveTo(160, 150); 
/ /路线 1 
path.lineTo(200, 150); 
// 路 线 2 
path.lineTo(180, 200); 
// 路 径 结束 
path.close(); 
canvas .drawPath (path, paint); 
//---- 绘 制 指定 路 径 图 形 
Path pathCircle = new Path(); 
// 添 加 一 个 圆 形 的 路 径 
pathCircle.addCircle(130, 260, 20, Path.Direction.CCW); 
//---- 绘 制 带 圆 形 的 路 径 文本 
canvas .drawTextOnPath ("PathText"，PathCircle，10，20， 
paint); 
Ll 
} catch (Exception e) { 
// TODO: handle exception 
} finally { 

if (canvas != null) 

sfh.unlockCanvasAndPost (canvas); 


项 目 运 行 效果 如 图 4-11 所 示 。 
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drawText 


4-11 Canvas 常用 函数 练习 


Paint 画笔 


Paint (画笔 ) 是 绘图 的 辅助 类 ， 其 类 中 包含 文字 与 位 图 的 样式 、 颜 色 等 属性 信息 。Paint 
的 常用 方法 如 下 : 
M setAntiAlias (boolean aa) 
作用 : 设置 画笔 是 否 无 锯齿 
参数 : true 表示 无 锯齿 ，false 表示 有 和 锯齿， 默认 为 false。 
可 以 通过 观察 如 图 4-12 所 示 的 效果 图 ， 更 加 形象 地 解释 此 方法 的 作用 。 
M setAlpha (inta) 
作用 : 设置 画笔 透明 度 
参数 : 透明 值 
M setTextAlign (Paint.Align align) 
作用 : 设置 绘制 文本 的 锚 点 
参数 : Paint.Align 类 中 的 常量 
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图 4-12 画笔 无 锯齿 


M measureText (String text) 
作用 : 获取 文本 内 容 的 宽度 
参数 : 文本 内 容 

M, setStyle (Style style) 
作用 : 设置 画笔 样式 
参数 ， 样式 实例 

M, setColor (int color) 
作用 : 设置 画笔 颜色 
参数 : 色 值 

M setStrokeWidth (float width ) 
作用 : 设置 画笔 的 粗细 程度 
参数 : 画笔 粗细 值 

M setTextSize (float textSize) 
作用 : 设置 画笔 在 绘制 文本 时 ， 文 本 字体 的 尺寸 
参数 : 尺寸 值 

M setARGB (int a, int r, int g, int b) 
作用 : 设置 画笔 的 ARGB 分 量 
第 一 个 参数 : 画笔 透明 度 分 量 
第 二 个 参数 : 画笔 红色 分 量 
第 三 个 参数 : 画笔 绿色 分 量 
第 四 个 参数 : 画笔 蓝 色 分 量 


熟悉 了 Paint 的 常用 函数 后 ， 通 过 实例 代码 深入 理解 这 个 类 。 新 建 项目 “PaintProject”， 
游戏 框架 为 SurfaceView 游戏 框架 ,项目 对 应 的 源 代码 为 “4-8 (Paint 画笔 ) ”。 修 改 
MySurfaceView 类 的 绘图 函数 如 下 : 
Public void myDraw() { 
try { 
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= sfh.lockCanvas (); 


if (canvas != null) { 


canvas.drawColor (Color .WHITE); 

As 设置 画笔 无 锯齿 

Paint paintl = new Paint(); 
canvas.drawCircle (40, 30, 20, paint1); 
paintl.setAntiAlias (true); 
canvas.drawCircle (100, 30, 20, paint1); 
//----- 设 置 画 笔 的 透明 度 

canvas .drawText (" 无 透明 度 "，100，70，new Paint()); 
Paint paint2 = new Paint () 

Paint2.setAlpha (0x77); 

canvas .drawText (" 半 透 明度 "，20，70，paint2); 
Wd 设置 绘制 文本 的 锚 点 

canvas .drawText (" 锚 点 "，20，90，new Paint () ) ; 
Paint paint3 = new Paint () 

// 设 置 以 文本 的 中 心 点 绘制 

paint3.setTextAlign (Paint.Align .CENTER); 
canvas .drawText (" 锚 点 "，20，105，Paint3) 
1 获取 文本 的 长 度 

Paint paint4 = new Paint () 

float len =paint4.measureText (" 文 本 宽度 :") ; 
canvas .drawText (" 文 本 长 度 :"+len，20，130，new Paint ()); 
NE 设置 画笔 样式 

canvas .drawRect (new Rect (20,140,40,160), new Paint()) 
Paint paint5 = new Paint () 

// 设 置 画 笔 不 填充 

paint5.setStyle (Style. STROKE); 

canvas .drawRect (new Rect (60,140,80,160), paint5); 
i 设置 画笔 颜色 

Paint paint6 = new Paint (); 

paint6.setColor (Color.GRAY); 
canvas.drawText ("灰色 "，30,，180, paint6); 
= 设置 画笔 的 粗细 程度 

canvas .drawLine (20, 200,70, 200, new Paint () ) ; 
Paint paint7 = new Paint () 
paint7.setStrokeWidth(7); 

canvas .drawLine (20, 220,70, 220,paint7); 
/= 设置 画笔 绘制 文本 的 字体 粗细 

Paint paint8 = new Paint () 
paint8.setTextSize (20) ; 

canvas .drawText ("文字 尺寸 "，20,，260, paint8); 
J 设置 画笔 的 ARGB 分 量 

Paint paint9 = new Paint (); 

paint9 .setARGB (0x77, Oxff, Ox00, 0x00); 
canvas .drawText (" 红 色 半 透明 "，20，290，Ppaint9) ; 
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} 
} catch (Exception e) { 
// TODO: handle exception 
} finally { 
if (canvas != null) 
sfh.unlockCanvasAndPost (canvas); 


项 目 运 行 效果 如 图 4-13 所 示 。 


图 4-13 画笔 练习 


Paint 画笔 类 提供 了 一 个 抗 锯齿 的 函数 ， 其 实 Canvas 画布 也 提供 了 绘图 抗 锯齿 的 函数 ， 
如 下 所 示 : 
M Canvas.setDrawFilter (DrawFilter filter) ; 
作用 : 为 画布 设置 绘图 抗 锯 齿 
参数 : 绘图 过 滤器 实例 
实例 化 一 个 DrawFilter 类 的 对 象 ， 代 码 如 下 所 示 : 


PaintFlagsDrawFilter pfd = new PaintFlagsDrawFilter (0, 
Paint.ANTI ALIAS FLAG | Paint.FILTER BITMAP FLAG); 


Bitmap 位 图 的 泻 染 与 操作 


Bitmap 是 图 形 类 ，Android 系统 支持 的 图 片 格式 有 png、jpg、bmp 等 。 

对 位 图 操作 在 游戏 中 是 很 重要 的 知识 点 ， 比 如 游戏 中 需要 两 张 除 了 大 小 之 外 其 他 完全 相 
同 的 图 ， 那 么 如 果 会 对 位 图 进行 缩放 操作 ， 很 容易 就 节约 了 一 张 图 片 资源 ， 这 样 既 节 约 了 美 
工 的 时 间 ， 更 节约 了 游戏 安装 包 的 大 小 ; 当然 除了 缩放 之 外 ， 还 有 很 多 操作 ， 例 如 对 位 图 进 
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行 旋转 、 镜 像 、 设 置 透明 等 等 操作 都 会 节约 很 大 的 资源 。 
首先 创建 一 张 位 图 实例 。 位 图 的 实例 不 能 通过 new， 如 果 想 通过 一 张 图 片 资源 文件 创建 
一 个 位 图 ， 则 要 通过 位 图 工厂 来 索引 图 片 资源 文件 ， 从 而 生成 一 张 位 图 实例 ， 如 下 所 示 : 
M BitmapFactory .decodeResource (Resources res,int Id) 
作用 : 通过 资源 文件 生成 一 张 位 图 
第 一 个 参数 ， 资源 实例 
第 二 个 参数 : 资源 ID 
懂得 如 何 通 过 图 片 资源 创建 位 图 实例 后 ， 下 面 就 来 详细 介绍 如 何 操作 位 图 。 创 建 项 目 
“BitmapProject”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 对 应 的 源 代码 为 “4-9 (Bitmap 位 图 
演 染 与 操作 ) ”。 
修改 MySurfaceView.java， 代 码 中 bmp 是 上 
位 图 实例 。 


ADT 自动 生成 的 icon.png 图 片 资源 生成 一 个 


Bitmap bmp = BitmapFactory.decodeResource (this.getResources (), 
R.drawable.icon); 


下 面 讲解 位 图 常用 的 操作 函数 : 
1 . 绘制 位 图 


public void myDraw() { 


canvas.drawBitmap (bmp, 0, 0, paint); 


} 

代码 中 使 用 的 drawBitmap 函数 说 明 如 下 。 

M drawBitmap (Bitmap bitmap, float left, float top, Paint paint) 
作用 : 在 画布 上 绘制 一 张 位 图 
第 一 个 参数 : 位 图 实例 
第 二 、 三 个 参数 : 位 图 的 X，Y 坐标 
第 四 个 参数 : 画笔 实例 

代码 执行 效果 如 图 4-14 所 示 。 

2 . 旋转 位 图 


Public void myDraw() { 


canvas.rotate(30, bmp.getWwidth()/2, bmp.getHeight ()/2); 
canvas.drawBitmap (bmp, 0, 0, paint); 
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图 4-14 绘制 位 图 


代码 中 使 用 的 rotate 函数 说 明 如 下 。 
M rotate (float degrees, float px, float py) 
作用 : 旋转 画布 
第 一 个 参数 : 画布 旋转 的 角度 
第 二 、 三 个 参数 : 画布 的 旋转 点 
如 果 旋 转 的 角度 大 于 0， 顺 时 针 旋 转 ， 旋 转 的 角度 小 于 0， 则 逆 时 针 旋 转 。 
代码 执行 效果 如 图 4-15 所 示 。 


图 4-15 旋转 画布 


Canvas 中 旋转 画布 还 有 一 个 函数 : rotate (float degrees ) ， 参 数 传 入 的 是 旋转 画布 的 
角度 ， 此 种 方法 无 法 设置 旋转 点 ， 默 认 旋转 点 为 屏幕 的 中 心 点 。 


e@ 如 果 希 望 图 片 的 旋转 是 以 图 片 中 心 点 进行 旋转 ， 那 么 在 使 用 rotate 旋转 画布 函数 对 画 
布 进行 旋转 时 ， 其 旋转 点 坐标 应 该 设置 为 图 片 的 中 心 点 坐标 ; 
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@ rotate 函数 是 对 整个 画布 进行 旋转 操作 ， 也 就 是 意味 着 ， 画 布 上 所 有 绘制 的 元 素 都 会 
因 画 布 的 旋转 而 进行 对 应 的 旋转 。 
例如 代码 修改 为 : 
public void myDraw() { 
a oe bmp .getWidth() /2，bmp.getHeight ()/2); 


canvas .drawBitmap (bmp, 0, 0, paint); 
canvas.drawBitmap (bmp, 100, 0, paint); 


当 旋 转 画 布 后 ， 绘 制 两 张 位 图 ， 观 察 如 图 4-16 所 示 的 效果 。 


图 4-16 整个 画布 进行 旋转 


通过 图 4-16 可 以 明显 看 出 ， 第 二 次 绘制 的 位 图 也 被 旋转 了 ! 当然 这 并 不 是 想 要 效果 ， 那 
么 如 果 只 想 对 一 张 位 图 进行 旋转 操作 该 如 何 实现 呢 ? 
这 就 需要 大 家 熟悉 Canvas 类 中 两 个 很 重要 的 函数 save() 与 restore(): 


@ Save(): 作用 是 用 于 保存 当前 画布 的 状态 ; 
@ restore(): 作用 是 恢复 上 次 保存 的 画布 状态 。 


这 两 个 函数 是 配对 出 现 的 ， 也 就 是 说 有 N 个 save0 函 数 出 现 ， 必 须 有 N 个 restore() 函 数 
对 应 出 现 ;， 当然 restore0) 函 数 的 出 现 次 数 可 以 大 于 save0 函 数 ， 但 是 绝对 不 能 让 save() 函 数 出 
现 的 次 数 大 于 restore() 函 数 。 

既然 有 对 画布 状态 进行 保存 和 状态 恢复 的 函数 ， 那 么 就 可 以 单独 对 一 张 位 图 进行 旋转 操 
作 了 ， 针 对 一 张 位 图 进行 旋转 操作 的 步骤 如 下 : 
对 画布 进行 旋转 之 前 ， 首 先 利用 画布 的 save0 函 数 将 其 画布 的 状态 保存 起 来 ， 然 后 对 画 
布 进行 旋转 ， 紧 接着 绘制 位 图 ， 最 后 当 位 图 绘制 完 后 将 画布 状态 恢复 。 
这 样 一 来 ， 不 管 画布 以 后 再 进行 绘制 位 图 、 图 形 、 还 是 其 他 操作 都 不 会 受到 影响 了 。 
对 位 图 旋转 代码 进行 修改 : 


Public void myDraw() { 
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canvas.save (); 

canvas.rotate(30, bmp.getWidth()/2, bmp.getHeight ()/2) 
canvas.drawBitmap (bmp, 0, 0, paint); 

canvas.restore (); 

canvas.drawBitmap (bmp, 100, 0, paint); 


项 目 运行 效果 如 图 4-17 所 示 。 


图 4-17 保存 画布 状态 


从 图 4-17 所 示 的 效果 可 以 看 到 第 二 张 位 图 的 绘制 并 没有 因 第 一 张 位 图 绘制 前 ， 对 画布 进 
行 旋转 而 受到 任何 的 影响 ， 这 全 归功 于 save() 与 restore() 两 个 函数 ! 

其 实 不 光 是 Canvas (画布 类 ) 中 的 旋转 函数 会 对 整个 画布 进行 操作 ， 还 有 画布 的 缩放 、 
画布 的 位 移 也 都 是 对 整个 画布 进行 操作 ， 所 以 大 家 一 定 要 牢记 : 当 对 画布 进行 缩放 、 旋 转 和 
位 移 操作 时 ， 为 了 保证 其 他 绘制 的 元 素 不 受 影响 ， 应 该 利用 save() 与 restore() 对 画布 进行 适当 
的 保存 与 恢复 操作 。 

以 上 介绍 的 位 图 旋转 ， 是 通过 对 画布 进行 操作 实现 的 。 除 此 之 外 还 有 一 种 对 位 图 进行 旋 
转 的 方式 ， 就 是 利用 矩 阵 Matrix 来 实现 如 图 4-15 的 效果 ， 代 码 如 下 所 示 : 

Public void myDraw() { 
Wi mx = new Matrix(); 


mx.postRotate(30, bmp.getWidth() / 2, bmp.getHeight() / 2); 
canvas.drawBitmap (bmp, mx, paint); 


首先 创建 一 个 矩阵 实例 ， 然 后 对 和 矩阵 进行 旋转 缩放 ， 最 后 在 使 用 画布 绘制 位 图 时 ， 将 矩 
形 信息 作为 参数 传 入 即 可 。 
Matrix 类 的 postRotate 函数 与 Canvas 中 的 rotate 函数 的 作用 相同 ， 参 数 表示 的 函数 也 都 
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- 致 
使 用 矩阵 对 位 图 进行 操作 时 ， 可 以 免 去 对 画布 的 状态 保存 和 恢复 ， 因 为 矩阵 就 是 针对 音 
独 位 图 进行 的 操作 ， 所 以 不 会 影响 画布 其 他 元 素 的 绘制 ， 当 然 这 里 所 说 的 对 位 图 的 操作 不 仅 
仅 是 旋转 ， 在 后 续 讲解 的 位 图 缩放 和 位 图 位 移 都 可 以 利用 矩阵 来 实现 。 
3 . 平移 位 图 


Public void myDraw() { 


canvas.save () 

canvas .translate (10, 10); 
canvas.drawBitmap (bmp, 0, 0, paint); 
canvas.restore (); 


代码 中 使 用 的 translate 函数 说 明 如 下 。 

M translate (float dx, float dy) 
作用 : 平移 画布 
第 一 个 参数 : 在 X 轴 上 平移 画布 距离 
第 二 个 参数 : 在 立轴 上 平移 画布 距离 

不 管 是 在 X 轴 还 是 在 Y 轴 上 进行 平移 ， 其 平移 的 距离 值 大 于 0 时 ， 则 表示 向 X 或 Y 轴 

的 正方 向 进行 平移 ， 当 平移 的 距离 值 小 于 0 时 ， 则 表示 向 X 或 Y 轴 的 负 方向 进行 平移 。 
项 目 运行 效果 如 图 4-18 所 示 。 


图 4-18 平移 画布 


当然 这 里 对 位 图 进行 平移 也 只 是 利用 画布 的 平移 来 实现 。 我 们 在 讲解 位 图 旋转 时 提 到 
过 ， 利 用 矩阵 也 可 以 完成 对 位 图 平移 的 操作 。 
利用 矩阵 对 位 图 进行 平移 : 


Public void myDraw() { 
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Matrix maT = new Matrix(); 
maT.postTranslate(10, 10); 
canvas.drawBitmap (bmp, maT, paint); 


矩阵 的 postTranslate 方法 与 画布 的 translate 方法 雷同 ， 这 里 不 再 效 述 。 
4 . 缩放 位 图 


public void myDraw() { 


canvas.save () 

canvas.scale(2f，2f，50 + bmp.getWidth() / 2, 50 + 
bmp .getHeight() / 2); 

canvas .drawBitmap (bmp, 50, 50, paint); 

canvas.restore(); 

canvas.drawBitmap (bmp, 50, 50, paint); 


代码 中 使 用 的 scale 函数 说 明 如 下 。 
M scale (float sx, float sy, float px, float py) 
作用 : 对 画布 进行 缩放 
第 一 个 参数 ， 对 画布 X 轴 的 缩放 比例 
第 二 个 参数 ， 对 画布 Y 轴 的 缩放 比例 
第 三 、 四 个 参数 :对 画布 缩放 的 起 始点 
第 一 、 二 个 参数 表示 的 X,Y 缩放 的 比例 是 相对 于 缩放 起 始点 进行 的 ， 分 别 表 示 X,Y 轴 缩 
放 的 比例 值 ， 坐 标 轴 的 比例 值 只 要 都 为 1 时 表示 画布 没有 进行 缩放 ， 当 比例 值 大 于 1 时 表示 
放大 ; 当 比 例 值 小 于 1 且 大 于 0 时 表示 缩小 。 


Canvas 中 表示 缩放 画布 的 还 有 一 个 函数 : scale ( float sx, float sy ) ， 两 个 参数 表示 缩放 画 
布 X 与 Y 轴 的 比例 值 ; 此 种 方法 无 法 设置 缩放 起 始点 ， 默 认 缩放 起 始点 为 屏幕 的 (0.0 ) 点 。 


项 目 运行 效果 如 图 4-19 所 示 。 

这 里 再 强调 一 下 ， 不 管 是 画布 的 旋转 还 是 缩放 ， 如 果 想 让 某 一 位 图 以 位 图 的 中 心 点 进行 
旋转 或 缩放 ， 那 么 旋转 的 旋转 点 或 缩放 的 起 始点 都 应 该 设置 为 ， 在 绘制 位 图 的 X、Y 的 坐标 
的 基础 上 分 别 再 加 上 位 图 宽 的 一 半 与 位 图 高 的 一 半 。 

@ 绘制 位 图 都 是 默认 从 位 图 的 左上 角 进 行 绘制 ; 
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e 对 于 一 个 规则 的 位 图 来 说 ， 当 用 其 位 图 的 X 坐标 加 上 位 图 宽 的 一 半 ， 用 其 位 图 的 Y 
坐标 加 上 位 图 高 的 一 半 ， 得 到 的 两 个 坐标 值 就 是 位 图 的 中 心 点 。 


图 4-19 ”画布 的 缩放 


利用 矩阵 对 位 图 进行 缩放 : 
Public void myDraw() { 
//X 轴 镜 像 
canvas.save () 
canvas.scale(-1，1，bmp.getWidth() / 2，bmp.getHeight() / 2); 
canvas.drawBitmap (bmp, 0, 0, paint); 
canvas.restore (); 
/VY 轴 镜 像 
canvas.save () ; 
canvas.scale(1，-1，bmp .getNidth() / 2, bmp.getHeight() / 2); 
canvas.drawBitmap (bmp, 0, 0, paint); 
canvas.restore (); 


这 里 利用 算 阵 对 位 图 缩放 时 ， 除 了 对 和 矩阵 进行 缩放 外 还 对 矩阵 进行 了 一 步 平移 操作 。 

其 实 细 心 的 大 家 可 能 早 就 观察 出 来 了 ， 利 用 矩阵 对 位 图 进行 操作 ， 存 在 一 个 缺点 就 是 位 
图 无 法 设置 其 位 置 ， 都 是 默认 放置 在 屏幕 的 〈0,0) 点 。 

例如 有 一 张 位 图 ， 想 将 位 图 绘制 在 (60,60〉 这 里 ， 然 后 再 对 位 图 进行 缩放 、 平 移 与 旋转 
操作 。 首 先 都 知道 对 位 图 的 操作 可 以 完全 利用 矩阵 来 实现 ， 但 是 在 绘制 带 和 矩阵 信息 的 位 图 方 
法 中 s 


drawBitmap (Bitmap bitmap, Matrix matrix, Paint paint) 


此 方法 是 无 法 设置 图 片 的 位 置 的 ， 利 用 此 种 带 和 矩阵 的 绘制 位 图 函数 ， 其 位 图 的 坐标 信息 
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放 在 了 矩阵 里 ， 而 矩阵 本 身 并 没有 设置 初始 位 置 的 函数 ， 此 时 只 能 利用 矩阵 的 平移 函数 来 弥 
补 这 个 问题 。 所 以 利用 矩阵 进行 操作 位 图 时 ， 当 位 图 不 想 默 认 放 在 画布 0.0) 点 时 候 ， 需 要 
通过 矩阵 的 postTranslate 函数 进行 位 图 位 置 的 设置 。 


5 . 镜像 反 转 位 图 


public void myDraw() { 

//X 轴 镜 像 

canvas.save (); 

canvas.scale(-1，1，100 + bmp.getWidth() / 2, 100 + 
bmp .getHeight() / 2); 

canvas.drawBitmap (bmp, 100, 100, paint); 

canvas.restore () 

//Y 轴 镜 像 

canvas.save (); 

canvas.scale(1l, -1, 100 + bmp.getWidth() / 2, 100 + 
bmp .getHeight() / 2); 

canvas.drawBitmap (bmp, 100, 100, paint); 

canvas.restore(); 


对 位 图 的 镜像 反 转 ， 利 用 画布 对 位 图 的 缩放 函数 来 实现 ; 在 之 前 讲解 缩放 位 图 时 ， 对 
scale (float sx, float sy, float px, float py) 函数 详细 介绍 过 其 四 个 参数 表示 的 含义 ， 但 是 对 其 
中 第 一 、 二 个 参数 表示 X、Y 轴 的 缩放 比例 值 的 范围 只 是 讲解 了 X、Y 值 都 大 于 0 的 情况 。 
当 X 轴 的 比例 值 小 于 0 时， 其实 是 对 画布 进行 X 轴 的 镜像 后 的 缩放 ;而 当 YY 轴 的 比例 值 小 于 
0 时 ， 是 对 画布 进行 Y 轴 镜 像 后 的 缩放 。 也 就 是 说 ， 当 X 或 者 立轴 的 缩放 比例 值 小 于 0 并 且 
大 于 -1 时 ， 是 对 画布 进行 X 或 Y 轴 镜 像 后 的 缩小 操作 ， 当 X 或 者 Y 轴 的 缩放 比例 值 小 于 -1 
时 ， 是 对 画布 进行 X、Y 轴 镜 像 后 的 放大 操作 。 所 以 如 果 只 是 想 让 位 图 沿 着 X 轴 或 者 Y 轴 进 
行 镜像 操作 ， 那 么 X 与 立 的 缩放 比例 都 应 该 设置 为 -1， 保 证 位 图 镜像 不 被 缩放 。 

因此 ， 对 位 图 进行 X 轴 的 镜像 操作 ， 只 需要 设置 X 轴 的 缩放 比例 为 -1 即 可 。 项 目 运行 效 
果 如 图 4-20 所 示 。 

对 位 图 进行 立轴 的 镜像 操作 ， 只 需要 设置 立轴 的 缩放 比例 为 -1 即 可 。 项 目 运行 效果 如 图 
4-21 所 示 。 
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图 4-20 X 轴 镜像 反 转 位 图 


图 4-21 YY 轴 镜像 反 转 位 图 


利用 和 矩阵 实现 对 位 图 的 镜像 操作 代码 如 下 : 


public void myDraw() { 
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//X 轴 镜 像 

canvas.drawBitmap (bmp, 0, 0, paint); 

Matrix maMiX = new Matrix(); 

maMix.postTranslate(100, 100); 

maMix.postSscale(-1, 1, 100 + bmp.getWidth() / 2, 100 + 
bmp .getHeight() / 2); 

canvas.drawBitmap (bmp, maMix, paint); 

//Y 轴 镜 像 

canvas.drawBitmap (bmp, 0, 0, paint); 

Matrix maMiY = new Matrix(); 
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maMiY.postTranslate(100，100) ; 


maMiY.postScale(1，-1，100 + bmp.getWidth() / 2, 100 + 
bmp .getHeight() / 2); 
canvas.drawBitmap (bmp，maMiY，Paint) 7 


在 介绍 位 图 时 ， 提 到 过 Android 系统 几 种 支持 的 图 片 格式 。 在 游戏 开发 中 ， 一 般 最 常用 
的 是 png 格式 的 图 片 ， 原 因 在 于 png 格式 的 图 片 支持 透明 度 。 
` 面 通过 举例 来 更 形象 的 阐述 常用 png 的 原因 。 

如 下 有 两 张大 小 、 内 容 相 同 的 图 片 ， 只 是 左 侧 的 位 图 是 由 一 张 png 的 半 透 明 图 片 创 建 而 
成 ， 而 右 侧 的 位 图 是 由 jpg 格 式 的 图 片 创建 而 成 ， 如 图 4-22 所 示 。 


图 4-22 绘制 png 或 jpg 的 位 图 


EL 


通过 画布 的 黑色 背景 衬托 ， 右 侧 jpg 格式 的 图 片 的 白色 背景 很 明显 地 显现 出 来 ， 而 左边 
是 png 的 半 透 明 图 ， 背 景 为 透明 ， 图 上 的 像素 也 全 部 半 透 明 。 

大 家 都 知道 画布 在 绘制 位 图 、 图 形 、 文 本 等 对 象 时 ， 其 覆盖 关系 都 是 按照 先后 顺序 。 比 
如 在 画布 上 绘制 两 张 相同 规格 与 格式 的 位 图 ， 首 先 绘制 了 位 图 bmp1， 然 后 在 相同 的 位 置 绘 
制 bmp2， 那 么 bmp2 会 覆盖 bmp1。 

下 面 通过 一 段 代码 更 好 地 解释 png 的 特性 : bmpPng 是 对 应 png 格式 的 位 图 ，bmpJpg 是 
对 应 jpg 格式 的 位 图 。 


public void myDraw() { 


// 左 侧 圆 形 与 png 位 图 

canvas.drawCircle(30, 15, 10, paint); 
canvas.drawBitmap (bmpPng, 0, 0, paint); 
// 右 侧 圆 形 与 jpg 位 图 

canvas.drawCircle(150, 15, 10, paint); 
canvas.drawBitmap (bmpJpg, 120, 0, paint); 
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项 目 运行 效果 如 图 4-23 所 示 。 


图 4-23 位 图 覆盖 的 不 同 效果 


从 上 面 代码 中 可 以 很 明显 地 看 出 ， 在 绘制 这 两 种 格式 的 位 图 之 前 首先 都 绘制 一 个 圆 形 。 
通过 图 4-23 可 以 看 出 ， 左 侧 圆 形 虽 然 被 png 格式 的 位 图 所 覆盖 ， 但 是 因为 这 张 png 的 图 是 半 
透明 ， 所 以 可 以 透 过 这 张 png 位 图 隐约 看 到 被 覆盖 的 圆 形 ， 而 右 侧 被 jpg 位 图 覆盖 的 圆 形 是 
无 法 看 到 的 ， 原 因 在 于 jpg 格式 的 图 片 无 法 保存 透明 度 ， 所 以 也 无 法 透 过 jpg 位 图 看 到 被 其 覆 
六 的 内 容 。 

这 里 虽然 简单 介绍 了 png 图 片 格式 的 好 处 ， 但 不 是 说 在 开发 游戏 中 必须 使 用 png 图 。 使 
用 什么 格式 的 图 片 ， 只 能 根据 具体 项 目的 需求 来 选择 。 比 如 单纯 地 希望 找 一 张 图 片 作为 游戏 
背景 ， 那 么 选用 jpg、png 或 者 bmp 格式 的 图 片 都 可 以 。 


剪 切 区 域 


剪 切 区 域 在 游戏 开发 中 也 是 画布 很 常用 的 一 个 图 数 ， 是 游戏 开发 需要 重点 掌握 的 知识 
点 。 前 切 区 域 也 称 为 可 视 区 域 ， 是 由 画布 进行 设置 的 ; 它 指 的 是 在 画布 上 设置 一 块 区 域 ， 当 
画布 一 旦 设置 了 可 视 区 域 ， 那 么 除 此 区 域 以 外 ， 绘 制 的 任何 内 容 都 将 看 不 到 ; 可 视 区 域 可 以 
是 个 圆 形 、 和 矩形 等 等 。 

新 建 项 目 “ClipCanvasProject”， 游 戏 框架 使 用 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代 
码 为 “4-10〈 可 视 区 域 ) ”。 修 改 MySurfaceView 类 中 的 绘图 函数 如 下 : 


public void myDraw() { 


canvas.clipRect (0, 0, 20, 20); 
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canvas.drawRect (0, 0, this.getWwidth(), this.getHeight(), paint); 


其 中 clipRect (int left, int top, int right, int bottom) 函数 的 作用 是 为 画布 设置 矩形 可 
视 区 域 。 函 数 第 一 、 二 个 参数 为 可 视 区 域 的 左上 角 坐 标 ， 第 三 、 四 个 参数 为 可 视 区 域 的 右 
下 角 坐 标 。 

项 目 运行 效果 如 图 4-24 所 示 。 


图 4-24 剪 切 区 域 


通过 上 面 代码 可 以 看 出 ， 要 绘制 的 矩形 是 个 等 同 于 画布 大 小 的 和 矩形， 但 是 从 图 4-24 的 效 
果 来 看 ， 并 不 是 预期 的 结果 ， 产 生 这 一 现象 的 原因 是 剪 切 区 域 在 发 生 作用 。 

代码 中 可 以 看 到 画布 在 绘制 矩形 之 前 设置 了 一 个 起 始点 坐标 (0.0) ， 宽 20， 高 20 的 矩 
形 ， 而 图 4-24 的 效果 显示 的 也 正好 是 一 个 起 点 为 〈0.0) ， 宽 高 都 是 20 的 矩形 ， 也 就 是 说 图 
4-24 的 效果 中 所 看 到 的 矩形 就 是 画布 设置 的 前 切 区 域 。 

这 里 要 注意 一 点 ， 因 为 Canvas 设置 剪 切 区 域 的 函数 也 是 对 整个 画布 进行 操作 ， 所 以 为 了 
避免 画布 上 其 他 绘制 的 元 素 受 到 影响 ， 在 设置 剪 切 区 域 前 ， 也 应 该 保存 画布 状态 ， 并 且 在 处 
理 过 后 还 原画 布 的 状态 。 因 此 ， 以 上 代码 应 该 修改 为 : 
public void myDraw() { 

canvas.save(); 
canvas.clipRect (0, 0, 20, 20); 


canvas.drawRect (0, 0, this.getwidth(),this.getHeight (),paint); 
canvas.restore (); 
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为 了 便于 观察 ， 下 面 对 一 张 图 片 设置 矩形 剪 切 区 域 。 首 先 将 如 图 4-25 所 示 的 图 片 放 入 项 
目 中 。 


图 4-25 image.png 
首先 通过 此 图 片 资 源 生成 一 张 Bitmap 位 图 : 


Bitmap bmp = BitmapFactory.decodeResource (this.getResources (), 
R.drawable.image); 


然后 修改 绘图 函数 ， 为 其 位 图 设置 矩形 可 视 区 域 : 


Public void myDraw() { 


canvas.save(); 
canvas.clipRect (0, 0, 20, 20); 


canvas.drawBitmap (bmp, 0, 0, paint); 
canvas.restore (); 


项 目 运行 效果 如 图 4-26 所 示 。 
图 4-26 所 示 的 左 侧 是 没有 设置 可 视 区 域 直接 绘制 位 图 的 效果 ， 而 右 侧 则 是 对 画布 设置 了 
可 视 区 域 的 效果 ， 通 过 此 对 比 图 可 以 明显 地 看 出 可 视 区 域 的 作用 。 
除了 设置 矩形 可 视 区 域 之 外 ， 画 布 还 提供 了 其 他 两 种 设置 可 视 区 域 的 方法 。 
@ 第 一 种 是 利用 Path 来 设置 可 视 区 域 的 形状 。 
M clipPath (Path path) 
作用 : 为 画布 设置 可 视 区 域 
参数 : Path 实例 
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图 4-26 设置 可 视 区 域 前 后 对 比 图 


利用 此 函数 ， 通 过 Path 可 以 为 画布 设置 任何 需要 的 可 视 区 域 ， 下 面 利用 Path 为 位 图 设置 
-个 贺 形 可 视 区 域 : 


public void myDraw() { 


canvas.save(); 

Path path = new Path(); 

path.addCircle (30, 30, 30, Direction.CCW); 
canvas.clipPath (path); 

canvas.drawBitmap (bmp, 0, 0, paint); 
canvas.restore(); 


项 目 运 行 效果 如 图 4-27 所 示 。 


图 4-27 利用 Path 设 置 可 视 | 


四 
沪 
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@@ 第 二 种 是 利用 Regin 来 对 画布 设置 可 视 区 域 。 
clipRegion (Region region) 


作用 : 为 


画布 设置 可 视 区 域 


参数 : Region 实例 


这 里 简单 


介绍 一 下 Region 这 个 类 : Region 表示 区 域 的 集合 ， 所 以 它 可 以 设置 多 个 区 域 


块 ， 而 且 可 以 通过 这 些 区 域 块 之 间 的 关系 来 处 理 一 些 问题 ; 比如 Region 设置 它 所 有 区 域 块 相 


交 的 区 域 是 否 


Region 常 


可 见 、 设 置 相 交 区 域 只 让 交集 显示 等 等 。 
用 的 函数 : 


M op (Rect rect, Op op) 


作用 : 


设置 区 域 块 


第 一 个 参数 : Rect 实例 

第 二 个 参数 ，Region.Op 静 态 值 ， 表 示 区 域 块 的 显示 方式 。 其 中 区 域 块 的 显示 方式 如 下 : 
e。 Region.Op.UNION: 区 域 全 部 显示 ; 
e。 Region.Op.INTERSECT: 区 域 的 交集 显示 ; 
e。 Region.Op.XOR: 不 显示 交集 区 域 。 


下 面 通过 


Region 设置 画布 可 视 区 域 : 


public void myDraw() { 


canvas.save(); 

Region region = new Region(); 

region.op (new Rect (20,20,100,100), Region.Op.UNION); 
canvas.clipRegion (region); 

canvas.drawBitmap (bmp, 0, 0, paint); 

canvas. restore (); 


项 目 运 行 效果 如 图 4-28 所 示 。 
在 上 面 代 码 中 ，region.op (new Rect(20,20,100,100)，Region.Op.UNION ) 的 参数 
Region.Op.UNION 表示 除了 此 区 域 与 Region 中 的 其 他 区 域 的 交集 部 分 外 都 显示 ; 但 是 其 作用 


仅仅 通过 一 个 
函数 如 下 : 


区 域 块 是 无 法 看 出 效果 的 ， 所 以 下 面 在 Region 中 再 设置 一 个 区 域 块 ， 修 改 绘图 


public void myDraw() { 


canvas.save(); 

Region region = new Region(); 

region.op (new Rect (20,20,100,100), Region .Op.UNION); 
region.op (new Rect (40,20,80,150), Region.Op.XOR); 
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canvas.clipRegion (region); 
canvas.drawBitmap (bmp, 0, 0, paint); 
canvas. restore () ; 


[9 


图 4-28 用 Region 设 置 可 视 区 域 


项 目 运 行 效 果 如 图 4-29 所 示 。 


图 4-29 ”Region 区 域 块 


从 图 4-29 中 可 以 看 出 ，Region 设置 的 第 一 个 区 域 块 全 部 显示 ， 第 二 个 区 域 块 没有 显示 交 
集 部 分 。 除 了 利用 Region 实现 设置 可 视 区 域外 ， 游 戏 开 发 中 还 经 常 利用 Region 来 检测 一 个 
点 或 者 一 个 和 矩形 等 是 否 在 与 Region 中 的 区 域 块 发 生 碰撞 ， 对 于 Region 的 这 个 功能 将 在 后 面 
介绍 碰撞 检测 时 再 详细 讲解 。 
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4.11 动画 


一 款 游戏 中 必 不 可 少 的 就 是 动态 的 元 素 ， 这 些 动 态 的 元 素 可 能 是 角色 的 移动 、 爆 炸 的 效 
果 、 过 场 的 特效 等 等 ， 那 么 针对 动画 的 形成 ， 本 节 将 介绍 两 种 方式 ， 一 种 是 系统 提供 的 
Animation 类 的 特效 ， 另 外 一 种 方式 是 由 自己 手动 实现 。 


4.11.1 Animation 动画 
在 Android 中 ， 系 统 提 供 了 动画 类 Animation， 其 中 又 分 为 四 种 动画 效果 : 


e AlphaAnimation: 透明 度 渐变 动画 ; 
e ScaleAnimation: 渐变 尺寸 缩放 动画 ; 
ee TranslateAnimation: 移动 动画 ; 

e@ RotateAnimation: 旋转 动画 。 


下 面 首先 详细 介绍 4 种 动画 效果 的 创建 方法 。 
(1) AlphaAnimation 透明 度 渐变 动画 
M Animation alphaA =new AlphaAnimation (float fromAlpha, float toAlpha) 
第 一 个 函数 : 动画 开始 时 的 透明 度 
第 二 个 参数 : 动画 结束 时 的 透明 度 
两 个 参数 的 取 值 范围 为 [0，1]， 从 完全 透明 到 完全 不 透明 。 
(2) ScaleAnimation 渐变 尺寸 缩放 动画 
M Animation scaleA = new ScaleAnimation (float fromX, float toX, float fromY, float toY, 
int pivotXType, float pivotX Value, int pivotY Type, float pivotY Value ) 
第 一 个 参数 : 动画 起 始 时 X 坐标 上 的 伸缩 比例 
第 二 个 参数 : 动画 结束 时 X 坐标 上 的 伸缩 比例 
第 三 个 参数 : 动画 起 始 时 YY 坐标 上 的 伸缩 比例 
第 四 个 参数 : 动画 结束 时 Y 坐标 上 的 伸缩 比例 
第 五 个 参数 : 动画 在 X 轴 相对 于 物体 的 位 置 类 型 
第 六 个 参数 : 动画 相对 于 物体 X 坐标 的 位 置 
第 七 个 参数 : 动画 在 Y 轴 相 对 于 物体 的 位 置 类 型 
第 八 个 参数 : 动画 相对 于 物体 Y 坐标 的 位 置 
其 中 位 置 类 型 分 为 以 下 三 种 : 


e Animation.ABSOLUTE: 相对 位 置 是 屏幕 左上 角 ， 绝 对 位 置 ; 
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e Animation.RELATIVE_TO_SELF: 相对 位 置 是 自身 View， 取 值 为 0 时 ， 表 示 相 对 于 
是 自身 左上 角 ， 取 值 为 1 是 相对 于 自身 的 右 下 角 ; 
ee Animation.RELATIVE_TO_PARENT: 相对 父 类 View 的 位 置 。 


(3) TranslateAnimation 移动 动画 
M Animation translateA = new TranslateAnimation (float fromXDelta float toXDelta, float 
fromY Delta, float toY Delta) 
第 一 个 参数 : 动画 起 始 时 XX 轴 上 的 位 置 
第 二 个 参数 : 动画 结束 时 义 轴 上 的 位 置 
第 三 个 参数 : 动画 起 始 时 立轴 上 的 位 置 
第 四 个 参数 : 动画 结束 时 立轴 上 的 位 置 
(4) RotateAnimation 旋转 动画 
M Animation rotateA = new RotateAnimation 〈 float fromDegrees, float toDegrees, int 
pivotXType, float pivotX Value, int pivotY Type, float pivotY Value ) 
第 一 个 参数 : 动画 起 始 时 的 旋转 角度 
第 二 个 参数 : 动画 旋转 到 的 角度 
第 三 个 参数 : 动画 在 X 轴 相 对 于 物件 位 置 类 型 
第 四 个 参数 : 动画 相对 于 物件 的 X 坐标 的 开始 位 置 
第 五 个 参数 : 动画 在 Y 轴 相 对 于 物件 位 置 类 型 
第 六 个 参数 : 动画 相对 于 物件 的 Y 坐标 的 开始 位 置 
在 Animation 中 的 四 种 动画 创建 都 是 new 出 来 的 ， 虽 然 创建 很 简单 ， 但 是 根据 参数 的 不 
同 可 以 构造 出 千变万化 的 动画 效果 。 不 管 哪 一 种 动画 ， 都 有 一 些 通 用 的 方法 ， 比 如 ; 


e@ ”restart(): 重新 播放 动画 ; 
e setDuration (int time ) : 设置 动画 播放 时 间 ， 单 位 是 毫秒 。 


动画 的 创建 完成 之 后 ， 接 下 来 就 是 如 何 启 动 动画 。 其 实在 View 视图 中 ， 启 动 动画 也 是 
非常 的 简单 ， 只 要 调用 View 类 的 startAnimation (Animation animation) 函数 即 可 。 知 道 了 动 
画 的 创建 与 播放 ， 下 面 就 创建 一 个 项 目 来 实战 演练 一 下 吧 。 

新 建 项 目 “AnimationProject”， 游 戏 框架 为 View 游戏 框架 ， 项 目 对 应 的 源 代码 为 “4- 
11-1 (Animation 动画 ) ”。 

首先 运行 项 目 ， 观 察 四 种 效果 的 截图 ， 如 图 4-30、 图 4-31、 图 4-32、 图 4-33 所 示 。 
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方向 键 1 渐变 选 明度 动画 效果 
方向 键 | 渐变 尺寸 伸缩 动画 效果 
方向 键 + 画面 转换 位 置 移动 动画 效果 
方向 键 -+ 画面 转移 旋转 动画 效果 


图 4-30 透明 渐变 动画 效果 


方向 键 1 渐变 透明 度 动画 效果 
方向 键 | 渐变 尺寸 伸缩 动画 效果 
方向 键 *- 画面 转换 位 置 移动 动画 效果 
方向 键 画面 转移 旋转 动画 效果 
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方向 键 1 渐变 迁 明 度 动画 效果 
方向 键 | 渐变 尺寸 伸缩 动画 效果 a 
方向 键 + 画面 转换 位 置 移动 动画 效果 a 


方向 键 -画面 转移 旋转 动画 效果 人 和 
方向 键 。 画面 转换 位 置 移动 动画 效果 


图 4-32 位 移动 画 效果 


方向 键 1 渐变 延明 度 动画 效果 
方向 键 | 渐变 尺寸 伸缩 动画 效果 
方向 键 *- 画面 转换 位 置 移动 动画 效果 
方向 键 画面 转移 旋转 动画 效果 
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在 项 目 代码 中 ， 绘 图 函数 简单 绘制 了 一 些 文本 信息 和 一 个 icon 位 图 。 


@Override 
protected void onDraw (Canvas canvas) { 
super .onDraw (canvas); 
// 黑 色 背景 
canvas.drawColor (Color. BLACK); 
canvas.drawText ("方向 键 + 渐变 透明 度 动画 效果 "，80，this.getHeight() - 80, 
paint); 
canvas .drawText ("方向 键 | 渐变 尺寸 伸缩 动画 效果 "， 80，this.getHeight () - 
60, paint); 
canvas.drawText ("方向 键 - 画面 转换 位 置 移动 动画 效果 "， 80，this.getHeight () 
- 40, paint); 
canvas.drawText ("方向 键 - 画面 转移 旋转 动画 效果 "， 80，this.getHeight () - 


207 paint}s 
// 绘 制 位 图 icon 
canvas.drawBitmap (bmp, this.getWidth() / 2 - bmp.getwidth() / 2， 


this.getHeight() / 2 - bmp.getHeight() / 2, paint); 
:4 


项 目 中 每 个 动画 的 实例 与 播放 都 由 不 同 的 四 方向 按键 触发 ， 按 键 监听 事件 函数 如 下 : 


QOverride 
Public boolean onKeyDown (int keyCode, KeyEvent event) { 

if (keyCode == KeyEvent.KEYCODE DPAD UP) {// 渐变 透明 度 动画 效果 
mAlphaAnimation = new AlphaAnimation(0.1f, 1.0f); 
mAlphaAnimation.setDuration (3000); 

// // 设 置 时 间 持 续 时 间 为 3000 毫秒 =3 秒 
this.startAnimation (mAlphaAnimation); 

} else if (keyCode == KeyEvent .KEYCODE DPAD DOWN) { 
mScaleAnimation = new ScaleAnimation (0.0f, 2.0f, 1.5f, 1.5f, 
Animation.RELATIVE TO PARENT, 0.5f, Animation.RELATIVE TO_ 
PARENT, 0.0f); 
mScaleAnimation.setDuration (2000) ; 
this .startRAnimation (mScaleAnimation); 

} else if (keyCode == KeyEvent .KEYCODE DPAD LEFT) { 
mTranslateAnimation = new TranslateAnimation(0, 100, 0, 100); 
mTranslateAnimation.setDuration (2000); 
this.startAnimation (mTranslateAnimation); 

} else if (keyCode == KeyEvent.KEYCODE DPAD RIGHT) { 
mRotateAnimation = new RotateAnimation (0.0f, 360.0f, Animation. 
RELATIVE TO SELF, 0.5f, Animation.RELATIVE TO SELF, 0.5f); 
mRotateAnimation.setDuration(3000); 
this.startAnimation (mRotateAnimation); 
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return super.onKeyDown (keyCode, event); 


每 个 按键 对 应 一 种 动画 ， 并 且 每 个 按键 一 旦 触发 ， 首 先 实例 动画 ， 然 后 设置 动画 的 播放 
时 间 ， 最 后 启动 此 动画 即 可 。 这 里 唯一 要 提醒 的 是 ，Animation 的 每 种 动画 都 是 对 整个 画布 进 
行 操作 。 
View 不 光 提供 了 这 四 种 特效 ， 也 对 特效 提供 了 监听 器 ;为 动画 设置 监听 的 步骤 如 下 ; 


已 夷 绪 首先 使 用 android.view.animation.Animation.AnimationListener 接口 ， 或 者 内 部 类 实 
现 此 接口 ; 

全 下 吏 然后 重 写 接口 的 3 个 抽象 函数 : 

Qoverride 

public void onAnimationStart (Animation animation) { 


// 动 画 开始 时 响应 的 函数 


} 

@Override 

public void onAnimationEnd (Animation animation) { 
// 动 画 结 束 时 响应 的 函数 

} 

QOverride 

public void onAnimationRepeat (Animation animation) { 
// 动 画 重播 时 响应 的 函数 

} 


三 个 函数 监听 动画 的 不 同 状态 ， 其 中 三 个 函数 的 参数 都 表示 当前 播放 的 或 者 播放 结束 的 
动画 实例 ; 通过 此 参数 可 以 对 多 个 设置 监听 的 动画 进行 判断 和 匹配 。 


多 还 吏 最 后 使 用 动画 实例 Animation.setAnimationListener ( AnimationListener listener ) 设置 
动画 监听 器 即 可 。 


4.11.2 自 定义 动画 


1. 动态 位 图 


在 介绍 游戏 框架 时 ， 曾 在 屏幕 上 让 文本 字符 串 跟 随 玩家 手指 移动 ， 从 而 形成 一 个 动态 的 
效果 ; 那么 让 一 张 位 图 形成 动态 效果 也 很 容易 ， 只 要 不 断 改 变 位 图 的 X 或 者 Y 轴 的 坐标 即 
可 。 下 面 就 利用 一 张 位 图 形成 海 的 波浪 效果 。 

新 建 项 目 “BitmapMovie”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代码 为 
“4-11-2-1 (动态 位 图 ) ”。 首 先 在 项 目 中 放 入 一 张 png 图 片 ， 如 图 4-34 所 示 ， 此 图 宽 为 
1388， 高 为 127。 
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4-34 波浪 图 片 


修改 MySurfaceView 类 。 
初始 化 添加 : 


// 声 明 一 张波 浪 位 图 
Private Bitmap bmp; 

// 声 明 波浪 图 的 X,Y 坐标 
Private int bmpX, bmpY; 


视图 构造 函数 : 


Public void surfaceCreated (SurfaceHolder holder) { 


bmp = BitmapFactory.decodeResource (this.getResources () ， 
R.drawable.water); 

// 让 位 图 初始 化 X 坐标 正好 充满 屏幕 

bmpX = -bmp.getWwidth ()+this.getWwidth () 7? 

// 让 位 图 绘制 在 画布 的 最 下 方 ， 且 图 片 Y 坐标 正好 是 《屏幕 高 -图 片 高 ) 

bmpY = this.getHeight() - bmp.getHeight (); 


根据 以 上 设置 ， 图 片 相对 于 屏幕 的 位 置 关系 如 图 4-35 所 示 ， 图 中 黑色 矩形 框 表 示 视图 的 
画布 〈 手 机 屏幕 ) 。 


4-35 位 置 对 关系 图 解 


这 里 再 次 强调 ， 使 用 SurfaceView 视图 ， 只 有 在 视图 执行 完 构造 函数 时 才 可 获取 视图 的 
宽 高 ， 在 此 之 前 获取 的 屏幕 (视图 ) 宽 和 高 都 为 0， 原因 是 SurfaceView 视图 还 没有 创建 。 
绘制 函数 : 
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Public void myDraw() { 


canvas.drawBitmap (bmp，bmpX，bmpY，Paint) ; 


逻辑 函数 : 
public void logic () { 


bmpX+=5; 


为 了 让 位 图 “ 动 ” 起来， 每 次 重 绘 屏幕 时 ， 让 位 图 的 X 坐标 加 5 个 像素 。 这 里 需要 注 
意 ，logic() 函 数 在 讲述 MySurfaceView 游戏 框架 时 已 经 介绍 过 ， 此 函数 也 可 以 放 在 线程 中 不 
断 地 调用 执行 ， 用 于 处 理 游戏 逻辑 。 

项 目 运 行 效果 如 图 4-36 所 示 。 


4-36 动态 位 图 效果 图 


2. 帧 动画 
上 一 小 节 是 利用 改变 位 图 的 义 或 者 Y 坐标 形成 动画 效果 。 当 然 在 游戏 开发 中 ， 很 多 动态 
的 帧 数 不 仅仅 只 有 一 帧 ， 所 以 本 节 讲 解 如 何 利用 多 帧 图 形成 的 动画 。 所 谓 帧 动画 ， 其 实 就 是 
- 帧 一 帧 按照 一 定 的 顺序 进行 播放 实现 的 。 
新 建 项 目 “FrameMovie”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代码 为 
“4-11-2-2 〈 帧 动画 ) ”。 在 项 目 中 导入 10 张 png 图 ， 这 十 张 图 片 正好 是 一 个 动态 小 鱼 的 所 
有 帧 数 ， 如 图 4-37 所 示 。 


175 


Android 游 戏 编程 之 从 零 开 始 


4 EE drawable-mdpi 
国 fsho.png 
司 fishl.png 
国 fish2.png 
国 fish3.png 
国 fish4.png 


国 fish5.png 
国 fsh6.png 
国 fish7.png 
国 fish8.png 
王 fish9.png 


图 4-37 10 张 小 鱼 的 png 图 


接 下 来 修改 MySurfaceView 类 。 首 先 声 明 一 个 位 图 数组 ， 用 于 存放 小 鱼 的 全 部 帧 ， 并 声 
明 一 个 当前 帧 的 mt 变量 ， 用 于 操作 当前 显示 帧 。 


Bitmap fishBmp[] = new Bitmap[10]; 
int currentFrame; 


在 构造 函数 中 ， 使 用 for 循 环 将 小 鱼 的 每 个 帧 存放 入 帧 数组 : 
Public MySurfaceView (Context context) { 
for (int i = 0; i < fishBmp.length; i++) { 


fishBmp[i] = BitmapFactory.decodeResource (this.getResources(), 
R.drawable.fish0 + i); } 


如 果 多 个 资源 文件 名 称 按照 一 定 规律 命名 的 话 ， 在 R 资源 文件 对 应 生成 的 ID 也 会 有 一 
定 规律 可 循 。 
绘图 函数 : 


public void myDraw() { 


canvas.drawBitmap (fishBmp [currentFrame], 0, 0, paint); 


逻辑 函数 : 
public void logic () { 


currentFramet+t+; 
if (currentFrame >= fishBmp.length) { 
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currentFrame = 0; 


为 了 让 动画 循环 播放 ， 所 以 对 当前 帧 需要 进行 控制 ， 当 小 鱼 播放 的 当前 帧 大 于 并 且 等 于 
小 鱼 帧 数组 时 ， 重 置 当前 帧 为 0 〈 小 鱼 的 第 0 帧 图 ) 。 
项 目 运 行 效果 如 图 4-38 所 示 。 


图 4-38 帧 动画 
3 . 剪 切 图 动画 
以 上 介绍 了 两 种 动态 效果 ， 这 里 再 介绍 一 种 游戏 中 最 常用 的 实现 动态 效果 的 方式 一 - 剪 切 


图 动画 。 剪 切 图 动画 类 似 于 帧 动画 的 形式 ， 唯 一 的 区 别 就 是 动态 物体 的 动作 帧 全 部 放 在 了 一 
张 图 片 中 ， 然 后 再 通过 设置 可 视 区 域 完成 。 剪 切 图 动画 如 图 4-39 所 示 。 


4-39 ”演示 效果 图 1 
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上 图 中 ， 外 层 较 大 的 矩形 是 画布 〈 手 机 屏幕 ) ， 小 矩形 是 可 视 区 域 。 图 中 可 以 看 到 有 一 
张 拥有 3 帧 的 位 图 ， 绘 制 到 画布 的 〈0,0) 点 ， 并 且 画 布设 置 了 一 个 与 每 帧 大 小 相同 的 可 视 
域 ， 因 此 画布 只 能 看 到 此 位 图 的 第 一 帧 。 那 么 ， 当 下 次 重 绘画 布 时 ， 将 位 图 往 X 轴 的 反方 
移动 一 帧 的 宽度 距离 ， 如 图 4-40 所 示 。 


可 Xl 


4-40 演示 效果 图 2 


此 时 画布 由 于 设置 了 可 视 区 域 的 缘故 ， 只 会 显示 第 二 帧 的 区 域 ， 那 么 按照 此 种 方式 就 可 
以 让 设置 的 可 视 区 域 显示 位 图 的 每 一 帧 ， 从 而 形成 动画 效果 。 下 面 来 看 一 个 剪 切 图 动画 的 范 
例 。 

新 建 项 目 “ClipBitmapMovie"， 游 戏 框架 为 SurfaceView 游戏 框架 ， 对 应 的 源 代码 为 “4- 
11-2-3〈 剪 切 图 动画 ) ”。 首 先 在 项 目 中 导入 一 张 png 图 ， 如 图 4-41 所 示 。 


a) 3) a) a) La) La) 


图 4-41 fish.png 
接 下 来 创建 位 图 实例 ， 定 义 当 前 帧 ， 并 实现 绘图 函数 : 


Bitmap bmpClipBmp = BitmapFactory.decodeResource (this .getResources () ， 
R.drawable.fish) 7 
int cureentFrame; 


public void myDraw () { 


canvas.save(); 

// 设 置 画 布 可 视 区 域 ( 大 小 是 每 帧 的 大 小 ) 

canvas.clipRect (0, 0, bmpClipBmp.getWidth() / 10, 
bmpClipBmp .getHeight ()); 

// 绘 制 位 图 


canvas.drawBitmap (bmpClipBmp, -cureentFrame * 
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bmpClipBmp .getwidth() / 10, 0, paint); 
canvas.restore () 7 


绘制 位 图 ， 上 面 代码 默认 绘制 在 画布 的 〈0.0) 点 ， 假 设 将 位 图 绘制 在 (xy) 点 ， 代 码 
应 修改 如 下 : 


public void myDraw () { 


canvas.save(); 

// 设 置 画布 可 视 区 域 (大 小 是 每 帧 的 大 小 ) 

canvas.clipRect (x, y, x+bmpClipBmp.getWidth() / 10, 
y+bmpClipBmp .getHeight ()); 

// 绘 制 位 图 

canvas.drawBitmap (bmpClipBmp, x-cureentFrame * 
bmpClipBmp .getWidth() / 10, y, paint); 

canvas.restore (); 


在 绘制 位 图 时 ， 位 图 的 X 坐标 应 该 减 去 当前 帧 乘 上 帧 的 宽度 ， 这 里 因为 小 鱼 的 所 有 帧 数 
高 度 相同 ， 所 以 不 需要 Y 轴 减 去 当前 帧 数 乘 上 帧 的 高 度 。 
逻辑 函数 代码 如 下 : 
Public void logic () { 
ee 
if (cureentFrame>=10){ 


cureentFrame=0; 


} 


逻辑 中 一 直 让 当前 帧 不 断 循环 变化 ， 这 样 每 次 重 绘画 布 都 会 显示 不 同 的 帧 ， 从 而 达到 动 


4. |》 游戏 适 屏 的 简 述 与 作用 


由 于 市 面 上 安装 Android 系统 的 机 型 不 断 增多 ， 出 现 了 各 种 分 辨 率 、 各 种 屏幕 尺寸 的 
Android 系统 手机 。 这 种 情况 下 ， 一 个 游戏 或 者 一 个 软件 能 否 在 所 有 的 Android 手机 上 正常 显 
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示 呢 ? 

注意 ， 这 里 说 的 是 能 否 在 不 同 Andriod 手机 上 正常 显示 ， 而 不 是 正常 运行 ! 因 为 所 有 
Android 应 用 只 要 不 牵扯 到 SDK 版 本 的 功能 限制 ， 都 能 正常 安装 和 运行 。 这 里 所 说 的 正常 显 
示 的 含义 举例 说 明 如 下 : 

例如 在 4.11.2 小 节 中 完成 了 一 个 动态 的 位 图 效果 ， 当 初始 化 波浪 位 图 的 Y 坐标 时 是 根据 
视图 的 宽 高 来 进行 设置 的 。 这 种 做 法 的 好 处 是 : 不 管 在 任意 宽 高 的 屏幕 上 运行 显示 时 都 能 自 
适应 屏幕 。 

假设 把 4.11.2 小 节 动 态 位 图 项 目 中 位 图 的 初始 化 代码 : 


bmpY = this.getHeight () - bmp.getHeight (); 


修改 为 : 


bmpY = 480 - 127; 


这 里 的 480 是 视图 的 高 ，127 是 波浪 图 片 的 高 。 
正常 情况 下 以 上 两 句 代码 得 到 的 bmpY 值 都 是 相同 的 ， 没 有 任何 问题 。 但 是 ， 如 果 玩 家 
突然 将 手机 横 屏 操作 呢 ? 效果 如 图 4-42 所 示 。 


图 4-42 横竖 屏 对 比 图 1 
通过 图 4-42 可 以 明显 看 出 ， 当 竖 屏 运 行 项 目 时 没有 任何 的 问题 ， 但 是 一 旦 使 用 横 屏 运行 
项 目 ， 则 在 画布 上 根本 看 不 到 波浪 位 图 。 原 因 很 简单 ， 语 名 “bmpY = 480 - 127;” 中 ，bmpY 
是 个 固定 的 坐标 353， 但 是 当前 使 用 的 模拟 器 的 宽 和 高 在 竖 屏 情况 下 为 : 宽 =320， 高 =480; 
横 屏 情况 下 : 宽 =480， 高 =320。 
通过 以 上 分 析 可 以 明显 看 出 ， 在 竖 屏 下 bmpY 的 值 超过 了 屏幕 的 高 度 ， 所 以 看 不 到 了 。 
但 是 如 果 bmpY 通过 屏幕 宽 高 来 设 定 的 话 : 


bmpY = this.getHeight () - bmp.getHeight (); 
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效果 如 图 4-43 所 示 。 


4-43 ”横竖 屏 对 比 图 2 


有 些 开 发 人 员 可 能 会 想到 利用 设置 禁止 横 屏 或 者 竖 屏 的 方式 来 解决 ， 但 是 在 不 同 分 辩 率 
的 手机 屏幕 上 仍旧 没有 从 根本 上 解决 问题 。 其 实 ， 这 里 只 是 拿手 机 的 横竖 屏 造 成 画布 宽 高 的 
不 同 来 诠释 不 同 分 辩 率 的 手机 机 型 。 

利用 视图 宽 高 来 设置 位 图 坐标 的 好 处 是 : 视图 的 宽 高 值 可 以 适应 不 同 分 辩 率 的 机 型 。 所 
以 ， 如 果 想 让 应 用 适应 更 多 的 Android 手机 ， 那 就 要 多 多 使 用 适 屏 的 做 法 来 开发 ， 这 样 能 节 
省 机 型 之 间 移 植 的 时 间 ， 毕 竟 一 款 手机 应 用 适应 的 机 型 越 多 利益 才 会 越 大 。 

常用 的 适 屏 做 法 有 : 利用 屏幕 宽 高 、 位 图 宽 高 来 设置 一 些 游戏 元 素 的 位 置 ; 字体 的 适 屏 
做 法 最 好 的 是 使 用 字体 图 ， 这 样 文字 不 会 因 手 机 分 辨 率 不 同 而 不 同 ， 毕 竟 图 片 大 小 是 固定 不 
变 的 。 


4 .1 池 让 游戏 主角 动 起 来 


通过 前 面 小 节 的 学 习 ， 已 经 对 位 图 绘制 、 操 作 以 及 画布 、 画 笔 的 常用 函数 有 了 一 定 了 解 
和 掌握 ， 此 小 节 将 讲述 如 何 控制 一 个 游戏 主角 的 移动 。 

此 小 节 一 方面 为 大 家 讲解 如 何 将 一 张 由 多 行 多 列 的 动作 帧 组 成 的 图 片 实现 动态 效果 ; 另 
一 方面 讲解 游戏 中 那些 与 玩家 直接 交互 的 可 控 对 象 ， 在 开发 时 应 该 注意 的 一 些 知识 要 点 与 细 
节 处 理 。 

新 建 项 目 “PlayerProject”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代 码 “4- 
13 〈 操 作 游戏 主角 ) ”。 首 先 在 项 目 中 导入 一 张 资源 图 片 ， 如 图 4-44 所 示 。 
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图 4-44 robot.png 


此 图 是 机 器 人 向 右 奔 跑 的 所 有 动作 帧 ， 每 帧 的 大 小 相同 ， 顺 序 从 上 往 下 ， 从 左 往 右 。 修 
改 MySurfaceView 类 如 下 。 

首先 声明 用 到 的 一 些 变量 : 

// 机 器 人 位 图 

Bitmap bmpRobot= BitmapFactory.decodeResource (this.getResources () ， 

R.drawable. robot); 

// 机 器 人 的 方向 常量 

final int DIR LEFT = 0; 

final int DIR RIGHT = 1; 

// 机 器 人 当前 的 方向 (默认 朝 右 方向 ) 

int dir = DIR RIGHT; 

// 动 作 帧 下 标 

int currentFrame; 

// 机 器 人 的 X,Y 位置 

int robot x, robot y; 


绘图 函数 : 
Public void myDraw () { 


drawFrame (currentFrame, canvas, paint); 


在 绘图 函数 中 ， 将 绘制 的 操作 都 封装 在 了 一 个 drawFrame0 方 法 中 ， 有 时 为 了 便于 观察 和 
修改 代码 ， 会 有 针对 性 地 进行 一 些 函 数 包 装 ， 当 然 一 般 这 样 做 是 为 了 增加 代码 的 可 复 用 性 。 
而 且 一 个 函数 的 代码 量 过 大 的 话 ， 也 会 造成 程序 异常 ! 

在 观察 drawFrame 函数 之 前 ， 首 先 为 大 家 讲解 一 个 知识 点 。 从 图 4-44 中 可 以 看 到 ， 机 器 
人 的 动作 帧 不 仅 都 放 在 了 一 张 位 图 上 ， 并 且 动 作 帧 的 十 二 帧 还 分 成 了 6X2 的 形式 排列 ， 那 么 
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如 何 利用 可 视 区 域 来 显示 每 一 帧 呢 ? 
其 实现 的 方式 类 似 于 之 前 讲解 过 的 “ 剪 切 图 动画 ”的 处 理 方式 ， 首 先 观察 一 下 图 4-45。 


图 4-45 robotpng 演示 图 


图 4-45 是 robotpng 图 片 的 示意 图 ， 图 中 数字 表示 的 是 动作 帧 的 下 标 序列 ， 从 0 帧 开始 


算 起 ， 十 二 帧 对 应 的 下 标 为 11。 


假设 画布 设置 了 一 个 可 视 区 域 ， 此 可 视 区 域 的 大 小 与 每 一 帧 的 大 小 相同 ， 并 且 可 视 区 域 
的 位 置 与 第 0 帧 的 位 置 相同 。 位 图 的 宽 高 设 为 : bmpW、bmpY， 每 帧 的 宽 高 设 为 : frameW、 
他 ameH， 每 一 帧 的 位 置 相 对 于 整个 位 图 的 坐标 位 置 设 为 : frameX、frameY 。 

那么 通过 图 片 的 宽 高 与 每 帧 的 宽 高 可 以 得 到 所 有 的 帧 在 这 个 位 图 上 被 分 为 了 几 行 几 列 。 
此 时 ， 列 数 为 col (col=bmpW/frameW) 。 

通过 以 上 设置 的 变量 可 以 求 出 每 一 帧 相对 于 整个 位 图 的 坐标 : 


Se 


第 0 帧 相对 于 位 图 的 坐标 : 
第 1 帧 相对 于 位 图 的 坐标 : 
第 2 帧 相对 于 位 图 的 坐标 : 


第 6 帧 相对 于 位 图 的 坐标 : 
第 7 帧 相对 于 位 图 的 坐标 : 
第 8 帧 相对 于 位 图 的 坐标 : 


frameX =0，frameY =0; 
frameX = frameW, frameY =0; 
frameX =2 x frameW, frameY =0; 


frameX =0，frameY =frameH; 
frameX =frameW, frameY =frameH; 


frameX =2 x frameW, frameY =frameH; 


由 此 就 可 以 得 出 每 一 帧 相对 于 整个 位 图 的 坐标 公式 : 


@ 下 标 为 信 帧 的 X 坐 标 : frameX=n%col x frameW; 
e@ 下 标 为 N 帧 的 立 坐标 : frameY=n/col x frameH; 


得 到 下 标 为 N 的 这 一 帧 位 置 后 ， 如 果 想 让 这 一 帧 显示 在 可 视 区 域 中 ， 那 么 这 一 帧 的 坐标 


应 该 是 : 


frameX=-ngscolXframeW: 
frameY=-n/colXframeH; 


掌握 了 这 个 公式 后 ， 接 下 来 看 封装 的 drawFrame 函数 : 
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public void drawFrame (int currentFrame, Canvas canvas, Paint paint) { 
int frameW = bmpRobot.getWidth() / 6; 
int frameH = bmpRobot.getHeight() / 2; 
// 得 到 位 图 的 列 数 
int col = bmpRobot .getWwidth() / frameW; 
// 得 到 当前 帧 相对 于 位 图 的 X 坐标 
int x = currentFrame % col * frameW; 
// 得 到 当前 帧 相对 于 位 图 的 Y 华 标 
int y = currentFrame / col * frameH; 
canvas.save(); 
// 设 置 一 个 宽 高 与 机 器 人 每 帧 相同 大 小 的 可 视 区 域 
canvas.clipRect (robot x, robot y, robot x + bmpRobot .getmidth() / 6， 
robot y + bmpRobot.getHeight () / 2); 
if (dir == DIR_ LEFT) {// 如 果 是 向 左 侧 移动 
// 镜 像 操作 
canvas.scale(-1, 1, robot x - x + bmpRobot.getWidth() / 2, robot y 
- Y + bmpRobot.getHeight () / 2); 
} 
canvas.drawBitmap (bmpRobot, robot x - x, robot y - y, paint); 
canvas.restore (); 


这 里 要 注意 的 是 因为 机 器 人 位 图 上 只 有 朝向 右 的 十 三 帧 动作 帧 ， 而 没有 朝向 左 侧 的 帧 ， 
所 以 可 以 对 位 图 进行 镜像 反 转 ， 使 其 得 到 朝向 左 的 所 有 动作 帧 。 至 于 如 何 为 画布 设置 可 视 区 
域 以 及 对 位 图 的 操作 ， 在 之 前 的 章节 中 已 经 详细 介绍 ， 这 里 不 再 效 述 。 

按键 事件 处 理 : 


@Override 
public boolean onKeyDown (int keyCode, KeyEvent event) { 
if (keyCode == KeyEvent .KEYCODE DPAD UP) { 
robot yy -= 5) 


if (keyCode == KeyEvent .KEYCODE DPAD DOWN) { 
robot y += 5; 

if (keyCode == KeyEvent .KEYCODE DPAD LEFT) { 
robot x -= 5; 
dir = DIR LEFT; 

让 

if (keyCode == KeyEvent .KEYCODE DPAD RIGHT) { 
IDDOLER t= 
dir = DIR RIGHT; 

} 


return super.onKeyDown (keyCode, event); 
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四 个 方向 实体 按键 对 应 位 图 的 坐标 进行 增加 或 者 减 小 ， 那 么 需要 注意 的 是 ， 当 用 户 单 击 
方向 的 左 或 者 右键 时 ， 不 要 忘记 改变 当前 播放 机 器 人 的 朝向 。 
逻辑 函数 : 


Private void logic() { 
currentFrame++; 
if (currentFrame >= 12) { 
currentFrame = 0; 


; 


逻辑 仍然 是 做 所 有 帧 数 的 循环 控制 ， 让 其 动作 帧 不 间断 重复 播放 ; 项 目 运 行 效果 如 图 4- 
46 所 示 。 


图 4-46 角色 移动 效果 图 


- 般 在 处 理 游戏 主角 行走 时 ， 不 可 能 让 用 户 每 次 都 重复 点 击 ， 这 样 对 玩家 来 说 操作 起 来 
很 累 。 一 直 按 下 一 个 方向 键 ， 能 持续 移动 主角 这 才 是 合理 的 。 
其 实 View 提供 的 实体 按键 监听 的 函数 onKeyDown 就 已 经 为 开发 者 提供 了 此 功能 ， 当 某 
向 按键 处 于 一 直 被 按 下 的 状态 时 ，onKeyDown 也 将 一 直 被 响应 。 
但 是 这 里 存在 一 个 问题 ， 当 一 直 按 下 一 个 方向 按键 进行 移动 主角 行走 时 ， 细 心 一 点 观察 
的 话 可 以 看 到 主角 的 行走 会 被 卡 了 一 下 ! 
其 实 这 个 问题 的 原因 是 可 以 解释 的 ， 因 为 onKeyDown 函数 本 身 只 是 用 于 监听 按键 按 下 
的 事件 。 当 按键 按 下 的 状态 保持 了 一 定 毫秒 后 ， 系 统 会 默认 进入 长 按键 状态 ， 并 不 停 的 响应 
此 函数 ， 那 么 从 一 次 按键 的 状态 转 入 长 按键 状态 系统 肯定 需要 一 个 时 间 来 判定 ， 也 正 是 因为 
这 个 原因 ， 才 会 出 当 长 按键 时 ， 主 角 的 移动 被 卡 了 一 下 的 现象 。 
对 此 进行 处 理 ， 处 理 的 方式 如 下 : 
首先 定义 四 个 方向 按键 的 变量 : 


dO 
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Private boolean isUp,isDown,isLeft,isRight; 


四 个 变量 分 别 表示 四 个 方向 按键 是 否 被 按 下 的 状态 ， 初 始 都 默认 为 false。 
在 onKeyDown 函数 中 对 用 户 按 下 的 方向 按键 进行 处 理 : 


public boolean onKeyDown (int keyCode, KeyEvent event) { 

if (keyCode == KeyEvent .KEYCODE DPAD UP) { 
isUp = true; 

} 

if (keyCode == KeyEvent .KEYCODE DPAD DOWN) { 
isDown = true; 

} 

if (keyCode == KeyEvent .KEYCODE DPAD LEFT) { 
isLeft = true; 
dir = DIR LEFT; 

3. 

if (keyCode == KeyEvent .KEYCODE DPAD RIGHT) { 
isRight = true; 
dir = DIR RIGHT; 

} 

return super.onKeyDown (keyCode, event); 


当 用 户 单 击 方向 按键 的 任意 一 个 按键 时 ， 使 按键 对 应 的 方向 变量 设置 为 true。 
然后 在 逻辑 函数 中 操作 主角 的 移动 : 


Private void logic() { 

if (isUp) { 
xXODOLEM -= 

; 

if (isDown) { 
robot y += 5} 

if (isLeft) { 
robot x -= 5} 

上 

if (isRight) { 
robot x += 5; 


. 


逻辑 中 一 直 对 定义 的 四 个 方向 变量 进行 判定 ， 只 要 在 按键 监听 函数 中 有 方向 按键 被 按 下 
时 ， 就 会 改变 定义 的 方向 变量 为 true， 一 旦 某 一 方向 变量 为 true 之 后 ， 逻 辑 中 就 会 对 主角 进 
行 移动 操作 。 
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当然 到 此 还 没有 处 理 结 束 ， 因 为 方向 变量 一 直 为 true， 罗 辑 中 就 会 对 主角 一 直 进行 移 动 
操作 ， 所 以 此 时 需要 按键 抬 起 函数 配合 完成 最 后 一 步 : 
Qoverride 
public boolean onKeyUp (int keyCode, KeyEvent event) { 
if (keyCode == KeyEvent .KEYCODE DPAD UP) { 
isUp = false; 
} 
if (keyCode 一 KeyEvent .KEYCODE DPAD DOWN) { 
isDown = false; 
} 
if (keyCode == KeyEvent .KEYCODE DPAD LEFT) { 
isLeft = false; 
if (keyCode == KeyEvent .KEYCODE DPAD RIGHT) { 
isRight = false; 
| 
return super.onKeyUp (keyCode, event); 


这 样 处 理 后 不 管 玩 家 是 短暂 的 点 击 实体 的 方向 按键 还 是 长 按 方 向 键 ， 只 要 按键 抬 起 ， 监 
上 听 按 键 抬 起 的 函数 onKeyUp 就 会 将 相应 定义 的 方向 变量 设置 为 false， 停止 逻 辑 对 主角 的 移动 
操作 。 

最 后 还 要 提醒 一 点 ， 不 管 是 在 按键 按 下 的 监听 函数 还 是 在 按键 抬 起 的 监听 函数 中 ， 对 于 
用 户 点 击 的 按键 键 值 进行 判定 时 ， 如 果 是 使 用 if()f}else if0{3.. 的 形式 进行 判断 的 话 ， 那 么 
当 用 户 同时 点 击 右 方向 键 以 及 下 方向 键 时 ， 监 听 函 数 只 能 匹配 到 一 个 方向 的 键 值 ， 但 是 如 果 
对 每 个 方向 的 键 值 都 是 使 用 if0{W..if0f7W... 这 种 形式 的 话 ， 用 户 同 时 按 下 右 方 向 键 与 下 方向 
键 时 ， 在 监听 函数 中 则 会 匹配 到 两 种 键 值 。 

当然 在 逻辑 函数 中 ， 对 于 自 定义 的 四 个 方向 变量 也 要 根据 需要 选择 使 用 让 的 形式 ， 如果 
就 是 想 控 制 主角 单方 向 移动 ， 那 就 使 用 if0){}else if0{Y... 的 形式 吧 。 


4 .| 4 而 撞 检测 


手机 游戏 开发 中 最 常用 到 三 种 检测 碰撞 的 方式 ， 分 别 是 : 和 矩形 碰撞 、 圆 形 碰撞 和 像素 碰 
撞 。 实 际 上 ， 与 其 说 是 三 种 碰撞 检测 方式 倒 不 如 说 是 两 种 ， 其 原因 会 在 最 后 介绍 像素 碰撞 时 
详细 阐述 。 
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4.14.1 ”和 拢 形 碰 撞 


所 谓 矩 形 碰撞 就 是 利用 两 个 矩形 之 间 的 位 置 关系 来 进行 判断 ， 如 果 一 个 矩形 的 像素 在 另 
外 一 个 矩形 之 中 ， 或 者 之 上 都 可 以 认为 这 两 个 矩形 发 生 了 碰撞 。 

如 果 单 纯 去 考虑 哪些 情况 会 判定 两 个 矩形 发 生 碰 撞 ， 倒 不 如 反思 维 考虑 两 个 矩形 之 间 不 
发 生 碰 撞 的 几 种 情况 ， 这 样 更 容易 想到 。 其 实 两 个 矩形 不 发 生 碰撞 的 情况 就 四 种 ， 如 图 4-47 
所 示 。 


图 4-47 和 矩形 不 发 生 碰撞 的 四 种 情况 


图 4-47 示意 了 两 个 矩形 之 间 永 不 会 发 生 碰撞 的 四 种 情况 。 下 面 通过 一 个 实例 项 目 来 完成 
对 应 的 四 种 判定 。 

新 建 项 目 “RectCollision”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代码 为 
“4-14-1 (和 矩形 碰撞 ) ”。 首 先 修改 MySurfaceView 类 如 下 : 


// 定 义 所 需 的 变量 : 

// 定 义 两 个 矩形 的 宽 高 坐标 

Private int xl = 10, yl = 110, wl = 40, hl = 40; 
Private int x2 = 100, y2 = 110, w2 = 40, h2 = 40; 
// 便 于 观察 是 否 发 生 了 碰撞 设置 一 个 标识 位 

Private boolean isCollsion; 

// 然 后 修改 绘图 函数 : 

public void myDraw () { 


// 判 断 是 否 发 生 了 碰撞 

if (isCollsion) {// 发 生 碰撞 
paint.setColor (Color .RED) ; 
Paint.setTextSize(20) 
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canvas .drawText ("Collision! ", 0, 30, paint); 


} else {// 没 发 生 碰撞 
paint.setColor (Color .WHITE); 


} 

/ /绘制 两 个 矩形 

canvas.drawRect (x1l, yl, xl1 + wl, yl + hl, paint); 
canvas.drawRect (x2, y2, x2 + w2, y2 + h2, paint); 


上 面 代码 中 ，isCollsion 这 个 变量 的 存在 主要 是 区 分 未 碰撞 和 已 碰撞 。 当 发 生 碰 撞 时 
(isCollsion 为 真 )》， 不 仅 改变 了 画笔 的 颜色 ， 还 绘制 了 一 句 文 本 信息 。 绘 制 文本 的 原因 是 因 
为 在 书 中 只 显示 黑白 两 色 ， 效 果 不 明 显 ， 为 了 让 大 家 从 项 目 截图 中 明显 的 看 出 其 区 别 而 添加 
的 。 

两 个 矩形 默认 坐标 和 宽 高 值 是 无 法 发 生 碰撞 的 ， 所 以 这 里 需要 对 其 中 一 个 矩形 跟随 触 屏 
点 进行 移动 操作 ， 这 个 操作 在 触 屏 事件 监听 函数 中 实现 : 


Pub1lic boolean onTouchEvent (MotionEvent event) { 
// 让 和 矩形 1 随 着 触 屏 位 置 移动 ( 触 屏 点 设 为 此 矩形 的 中 心 点 ) 
xl = (int) event.getX() - wl / 2; 
yl = (int) event.getY() - hl / 2; 

// 当 矩形 之 间 发 生 碰撞 

if (isCollsionWithRect (xl1, yl, wl, hl, x2, y2, w2, h2)) { 
isCollsion = true; // 设 置 标识 位 为 真 
// 当 矩形 之 间 没 有 发 生 碰 撞 

} else { 
isCollsion = false;// 设 置 标识 位 为 假 

: 

return true; 


接 下 来 讲解 封装 的 矩形 碰撞 的 函数 : 


Q@param xl 第 一 个 矩形 的 X 坐标 
eparam yl 第 一 个 矩形 的 Y 坐标 
Q@param wl 第 一 个 矩形 的 宽 
@param hl 第 一 个 矩形 的 高 
eparam x2 第 二 个 矩形 的 X 坐标 
Q@param y2 第 二 个 矩形 的 Y 坐 标 
eparam w2 第 二 个 矩形 的 宽 
Q@param h2 第 二 个 矩形 的 高 
@return 
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Public boolean isCollsionWithRect (int xl1, int yl, int wl, int hl, int x2, 
int y2, int w2, int h2) { 
// 当 和 矩形 1 位 于 算 形 2 的 左 侧 
if (xl >= x2 && xl1 >= x2 + w2) { 
return false; 
// 当 矩形 1 位 于 矩形 2 的 右 侧 
} else if (xl <= x2 && xl + wl <= x2) { 
return false; 
// 当 矩形 1 位 于 矩形 2 的 上 方 
} else if (yl 3= y2 &6 yl >= y2 + h2) { 
return false; 
// 当 矩形 1 位 于 矩形 2 的 下 方 
Delse ie (vi < YY2FERYIETEDTER YY2) 
return false; 


// 所 有 不 会 发 生 碰撞 都 不 满足 时 ， 肯 定 就 是 碰撞 了 


return true; 


在 两 个 算 形 之 间 进 行 碰撞 检测 时 ， 不 仅仅 要 判定 两 者 X、Y 坐标 之 间 的 位 置 关 系 ， 还 
要 考虑 到 两 个 矩形 的 宽度 与 高 度 。 


项 目 运 行 效果 如 图 4-48 所 示 。 


图 448 ” 逢 形 碰撞 效果 图 


4.14.2 ” 圆 形 碰撞 


圆 形 之 间 的 碰撞 ， 主 要 是 利用 两 圆心 的 圆心 距 进行 判定 的 ， 当 两 圆 的 圆心 距 小 于 两 圆 半 


190 


第 4 章 ”游戏 开发 基础 


径 之 和 时 ， 判 定 发 生 了 碰撞 。 下 面 用 一 个 范例 进行 说 明 。 

新 建 项 目 “CircleCollision”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代码 为 
“4-14-2( 圆 形 碰撞 ) ”。 这 里 主要 分 析 一 下 圆 形 碰撞 的 检测 方法 ， 其 余 代 码 可 以 自行 查看 
源 代码 。 

将 圆 形 碰撞 函数 封装 为 一 个 方法 isCollisionWithCircle: 


* 圆 形 碰撞 

* @param xl 圆 形 1 的 圆心 X 坐标 
* @param yl 圆 形 2 的 圆心 X 坐标 
* @param x2 圆 形 1 的 圆心 Y 坐标 
* @param y2 圆 形 2 的 圆心 Y 坐标 
* @param rl 圆 形 1 的 半径 

* @param r2 圆 形 2 的 半径 

* @return 


Private boolean isCollisionWithCircle (int xl1, int yl, int x2, int y2, 
int rl int r2) 
//Math.sqrt: 开 平方 
//Math.pow(double x，double y): X 的 Y 次 方 
if (Math.sgqrt(Math.pow(xl - x2, 2) + Math.pow(yl - y2, 2)) 
<= zl + r2) { 
// 如 果 两 圆 的 圆心 距 小 于 或 等 于 两 圆 半径 则 认为 发 生 碰撞 
return true; 
} 
return false; 


项 目 运 行 效果 如 图 4-49 所 示 。 


图 4.49 贺 形 碰撞 
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4.14.3 ”像素 碰撞 


对 于 碰撞 检测 已 经 介绍 了 和 矩形 与 圆 形 两 种 方式 ， 其 实 使 用 这 两 种 检测 方式 不 是 很 精确 。 
比如 两 张大 小 相同 的 带 透明 度 的 png 图 ， 如 图 4-50 所 示 。 


@ @ 


png 位 图 1 png 位 图 2 
图 4-50 示意 图 1 


每 张 位 图 的 外 侧 和 矩形 表 示 每 张 位 图 的 大 小 边界 ， 每 张 位 图 中 间 填 充 的 黑色 圆 形 表示 有 像 
素 的 点 ， 每 张 位 图 中 空白 〈 白 色 ) 区 域 则 表示 png 位 图 中 的 透明 像素 。 这 种 带 透 明 像 素 的 图 
形 之 间 ， 如 果 利 用 矩形 来 进行 碰撞 ， 肯 定 不 能 以 图 的 大 小 进行 碰撞 检测 ! 

以 两 张 位 图 大 小 来 进行 碰撞 检测 的 示意 图 如 图 4-51 所 示 。 


图 4-51 示意 图 2 


按照 两 张 位 图 大 小 进行 检测 碰撞 ， 那 么 如 图 4-51 所 示 的 就 是 两 张 位 图 已 经 发 生 了 碰撞 的 
情况 。 但 是 大 家 思考 一 下 ， 如 果 将 图 4-51 所 示 的 这 样 两 张 带 透明 像素 的 图 绘制 在 面 布 上 ， 并 
且 两 个 位 图 的 位 置 关系 也 如 图 4-51 所 示 ， 站 在 玩家 的 角度 来 说 ， 他 们 关注 的 只 有 两 张 位 图 上 
非 透明 像素 的 两 个 贺 形 ， 很 明显 这 两 个 贺 形 并 没有 发 生 碰撞， 对 于 玩家 来 说 这 是 无 法 接受 的 ! 
虽然 事实 上 两 张 位 图 确实 发 生 了 碰撞 ， 但 是 对 玩家 而 言 ， 这 是 个 Bug。 

出 现 此 类 问题 的 原因 就 是 碰撞 区 域 的 不 精确 ! 当然 为 了 让 其 碰撞 更 加 的 真实 ， 解 决 的 办 
法 也 有 很 多 ; 

。 第 一 种 方法 是 仍然 利用 矩形 碰撞 的 方法 ， 但 是 要 设置 矩形 碰撞 区 域 大 小 ， 其 大 小 最 好 
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是 刚刚 好 包 住 位 图 的 黑色 圆 形 ( 非 透明 像素 区 域 ) 


第 二 种 方法 就 是 直接 利用 圆 形 碰撞 ， 而 碰撞 的 圆 形 区 域 与 位 图 的 黑色 圆 形 ( 非 透明 像 
素 ) 大 小 一 致 。 


针对 示意 图 表示 的 这 样 两 张 png 位 图 来 说 ， 虽 然 圆 形 碰撞 方法 明显 会 优胜 于 和 矩形 碰撞 ， 
但 是 一 旦 需要 检测 碰撞 的 两 张 png 带 透明 像素 的 图 ， 并 且 两 张 图 的 非 透明 像素 区 域 又 不 是 规 
则 的 图 形 ， 那 又 该 如 何 更 真实 的 模拟 碰撞 呢 ? 此 时 就 体现 出 了 像素 碰撞 的 优势 ! 

像素 碰撞 是 怎么 模拟 碰撞 的 呢 ? 首先 遍历 算出 一 张 位 图 所 有 的 像素 点 坐标 ， 然 后 与 另外 
一 张 位 图 上 的 所 有 点 坐标 进行 对 比 ， 一 旦 有 一 个 像素 点 的 坐标 相同 ， 就 立刻 取出 这 两 个 坐标 
相同 的 像素 点 ， 通 过 位 运算 取出 这 两 个 像素 点 的 最 高 位 〈 透 明度 ) 进行 对 比 ， 如 果 两 个 像素 
点 都 是 非 透 明 像素 则 判定 这 两 张 位 图 发 生 碰撞 。 

介绍 了 像素 碰撞 之 后 可 以 得 到 两 个 结论 


@ 像素 碰撞 很 精确 ， 不 论 位 图 之 间 是 否 带 有 透明 像素 ， 都 可 以 精确 判断 ; 
@ 正 是 因为 像素 碰撞 的 这 种 高 精确 判定 ， 从 而 也 会 造成 代码 效率 明显 降低 ! 
8 ”假设 两 张 100 x 100 大 小 的 位 图 利用 像素 级 检测 碰撞 ， 仅 是 遍历 两 张 位 图 的 像素 
点 就 要 循环 100 x 100 x 2=20000 名 逻辑 代码 ;况且 还 要 对 筛选 出 来 的 相同 坐标 
的 像素 点 进行 遍历 对 比 其 透明 值 ! 这 种 效率 可 想 而 知 ! 


当然 ， 这 里 的 像素 碰撞 只 是 大 致 提供 一 种 思路 ， 肯 定 还 可 以 进行 代码 优化 ， 但 是 不 论 再 
优 的 代码 ， 使 用 像素 级 进行 碰撞 检测 终 会 导致 整个 程序 的 运行 效率 大 大 降低 。 因 此 像素 级 别 
的 碰撞 检测 在 手机 游戏 开发 中 是 尽量 避免 使 用 的 ! 所 以 这 里 也 不 再 详细 讲解 。 

像素 级 的 碰撞 检测 是 不 推荐 使 用 的 ， 但 是 它 的 精确 程度 是 其 他 方法 无 法 代替 的 ; 不 过 ， 
这 并 不 代表 游戏 开发 中 就 没有 更 精确 的 检测 方式 了 ! 

- 般 游 戏 开发 中 ， 取 代 像 素 级 碰撞 检测 的 方法 是 利用 “多 矩形 ”、“ 多 圆 形 ”的 检测 方 
式 来 实现 的 。 


4.14.4 “多 和 珑 形 碰 撞 
所 谓 多 矩形 碰撞 ， 顾 名 思 义 就 是 设置 多 个 矩形 碰撞 区 域 ， 如 图 4-52 所 示 。 


3 


图 4-52 不 规则 图 例 
图 4-52 的 左 侧 是 原 图 ， 右 侧 则 是 在 原 图 的 基础 上 设置 了 两 个 矩形 碰撞 区 域 。 观 察 图 中 右 
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侧 可 明显 看 出 两 个 矩形 正好 将 原 图 中 非 透 明 的 像素 点 包 起 来 。 这 样 做 的 好 处 是 : 


。 更 精确 的 检测 碰撞 方法 ， 精 确 度 基本 同 于 像素 级 ; 
@ 相对 于 像素 级 的 碰撞 检测 ， 这 种 做 法 效率 更 高 。 


新 建 项 目 “MoreRectCollision”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代码 
为 “4-14-4《〈 多 和 矩形 碰撞 ) ”。 

对 多 个 矩形 进行 碰撞 检测 ， 首 先 应 该 处 理 一 个 矩形 的 碰撞 检测 。 关 于 矩形 的 碰撞 检测 ， 
在 之 前 介绍 和 矩形 碰撞 时 已 经 封装 过 方法 ， 这 里 对 其 代码 进行 修改 : 


public boolean isCollsionWithRect (Rect rect, Rect rect2) { 

//x1，y1: 和 矩形 1 的 左上 角 

int xl1 = rect.left; 

int yl = rect.top; 

//wl: 和 矩形 1 的 宽 

int wl = rect.right - rect.left; 

//h1: 和 矩形 1 的 高 

int hl = rect.bottom - rect.top; 

//x2，y2: 算 形 2 的 左上 角 

int x2 = rect2.left; 

int y2 = rect2.top; 

//w2: 和 矩形 2 的 宽 

int w2 = rect2.right - rect2.left; 

//h2: 算 形 2 的 高 

int h2 = rect2.bottom - rect2.top; 

if (xl >= x2 && xl >= x2 + w2) { 
return false; 

} else if (xl <= x2 && xl + wl <= x2) { 
return false; 

} else if (yl >= y2 && yl >= Y2 + h2) { 
return false; 

} else if (yl <= y2 && yl + hl <= y2) { 
return false; 


} 
return true; 


Rect 类 中 定义 了 矩形 坐标 属性 top、bottom、left、right。 


left: 表示 和 形 左 上 角 坐 标的 X 坐标 
top: 表示 和 矩形 左上 角 坐 标的 Y 坐标 
right: 表示 欠 形 右 下 角 的 义 坐标 
bottom: 表示 短 形 右 下 角 的 立 坐标 


对 一 个 矩形 的 碰撞 检测 封装 好 了 ， 下 面 就 再 次 对 其 进行 修改 ， 使 之 支持 多 矩形 碰撞 
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public boolean isCollsionWithRect (Rect[] rectArray, Rect[] rect2Array) { 
Rect rect = null; 
Rect rect2 = null; 
for (int i = 0; i < rectArray.length; i++) { 
// 依 次 取出 第 一 个 矩形 数组 的 每 个 矩形 实例 
rect = rectArray[il]; 


// 获 取 到 第 一 个 矩形 数组 中 每 个 矩形 元 素 的 属性 值 


int xl = rect.left + this.rectX1; 
int yl = rect.top + this.rectYl; 
int wl = rect.right - rect.left; 
int hl = rect.bottom - rect.top; 


for (int j = 0; j < rect2Array.length; j++) { 

// 依 次 取出 第 三 个 算 形 数组 的 每 个 矩形 实例 

rect2 = rect2Array[j]; 

// 获 取 到 第 二 个 矩形 数组 中 每 个 矩形 元 素 的 属性 值 
int x2 = rect2.1left + this.rectx2; 
int y2 = rect2.top + this.rectY2; 
int w2 = rect2.right - rect2.left; 
int h2 = rect2.bottom - rect2.top; 
/ /进行 循环 遍历 两 个 矩形 碰撞 数组 所 有 元 素 之 间 的 位 置 关系 
FR 
else if (xl <= x2 && xl + wl <= x2) { 
@lse if (yl >= y2 && yl >= y2 + h2) { 
else if (yl <= y2 && yl + hl <= y2) { 
else { 
// 只 要 有 一 个 碰 接 矩形 数组 与 男 一 碰撞 矩形 数组 发 生 碰撞 则 认为 碰撞 


return true; 


一 一 一 


1 
); 
return false; 


上 面 代码 就 是 遍历 两 个 碰撞 矩形 数组 每 个 矩形 之 间 的 位 置 关 系 ， 一 旦 有 一 个 矩形 数组 中 
的 矩形 与 另外 一 个 矩形 数组 的 矩形 发 生 碰 撞 就 可 认为 发 生 了 多 矩形 碰撞 。 

项 目 运行 效果 如 图 4-53 所 示 。 

由 于 多 圆 形 的 碰撞 检测 类 似 于 多 甜 形 碰撞 ， 所 以 这 里 就 不 再 资 述 。 
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Collision ! 


二 


Collision ! Collision ! 


eo 启 


图 4-53 多 甜 形 碰撞 


4.14.5 ”Region 碰撞 检测 
在 之 前 介绍 过 Region 这 个 类 ， 其 实 此 类 还 有 一 个 比较 常用 的 方法 就 是 用 于 判断 一 个 点 是 
和 否 在 矩形 区 域内 ， 其 方法 是 使 用 Region 类 中 的 contains (int x, inty) 函数 。 
M Contains (int x, inty) 
作用 : 用 于 判断 一 个 点 是 否 在 Region 的 矩形 区 域 中 
两 个 参数 : 点 的 X、Y 坐标 
新 建 项 目 “RegionCollision”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代码 为 
“4-14-5 (Region 碰撞 检测 ) ”。 修 改 MySurfaceView 类 代码 如 下 : 
// 定 义 碰撞 矩形 


Private Rect rect = new Rect(0, 0, 50, 50); 
/ /定义 Region 类 实例 

Private Region r = new Region(rect); 

/ /表示 是 否 发 生 碰撞 的 标识 位 


Private boolean isInclugde; 
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// 绘 图 函数 : 
public void myDraw () { 


// 标 识 位 为 真 时 ， 绘 制 icon 图 
if (isInclude) { 
canvas .drawBitmap (BitmapFactory.aecodeResource (this 
.getResources(), R.drawable.icon), 100, 50, paint); 
} 
// 绘 制 矩形 区 域 〈 便 于 观察 ) 


canvas.drawRect (rect, paint); 


// 触 屏 事件 : 


Public boolean onTouchEvent (MotionEvent event) { 

// 判 定 用 户 触 屏 的 坐标 点 是 否 在 碰撞 矩形 内 

if (r.contains ( (int) event.getX()， (int) event.getY())) { 
isInclude = true; 

} else { 
isInclude = false; 

上 

return true; 


项 目 运行 效果 如 图 4-54 所 示 。 图 中 的 左 侧 是 运行 初始 效果 ， 右 侧 是 当 用 户 触 屏 位 置 在 白 
色 碰 撞 矩 形 内 的 效果 。 


图 4-54 ”Region 碰撞 检测 
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人 四. ] 9 游戏 音乐 与 音效 


在 一 款 游戏 中 ， 除 了 华丽 的 界面 UI 直接 吸引 玩家 外 ， 另 外 重要 的 就 是 游戏 的 背景 音乐 
与 音效 ; 合适 的 背景 音乐 以 及 精彩 的 音效 搭配 会 令 整 个 游戏 上 升 一 个 档次 。 

在 Android 中 ， 常 用 于 播放 游戏 背景 音乐 的 类 是 MediaPlayer， 而 用 于 游戏 音效 的 则 是 
SoundPool 类 ， 至 于 MediaPlayer 与 SoundPool 之 间 的 区 别 将 在 讲解 两 者 的 使 用 方法 后 详细 的 
进行 分 析 。 


4.15.1 MediaPlayer 
MediaPlayer 实例 化 不 是 new 出 来 的 ， 而 是 通过 调用 静态 方法 create (Context context, int 
resid) 得 到 的 。 除 获取 实例 以 外 ，MediaPlayer 类 常用 的 函数 如 下 : 
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prepare(): 为 播放 音乐 文件 做 准备 工作 。 
start(): 播放 音乐 。 

pause(): 暂停 音乐 播放 。 

stop(): 停止 音乐 播放 。 


暂停 音乐 与 停止 音乐 ， 主 要 的 区 别 在 于 : 暂停 音乐 播放 后 ， 可 继续 播放 ， 再 次 调用 start() 
函数 即 可 ;停止 音乐 播放 后 ， 无 法 继续 播放 ， 必 须 重 新 做 播放 音乐 的 准备 工作 prepare0， 然 
后 再 调用 start0) 函 数 进行 播放 音乐 。 

Mediaplayer 类 的 其 他 常用 函数 : 

1. setLooping(boolean looping) 

作用 : 设置 音乐 是 否 循环 播放 

参数 : true 表示 循环 播放 ，false 表示 不 循环 播放 

2. seekTo(int msec) 

作用 : 将 音乐 播放 跳 转 到 某 一 时 间 点 

参数 : 跳 转 时 间 (以 毫秒 为 单位 ) 

3. getDuration() 

作用 : 获取 播放 的 音乐 文件 总 时 间 长 度 

4. getCurrentPosition() 

作用 :得 到 当前 播放 音乐 的 时 间 点 

除 此 之 外 ， 还 需 介 绍 音乐 管理 类 AudioManager， 它 提供 了 获取 当前 音乐 大 小 以 及 最 大 音 
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AudioManager 类 常用 函数 : 

1. setStreamVolume(int streamType, int index, int flags) 
作用 : 设置 音量 大 小 

第 一 个 参数 .音量 类 型 (音乐 的 常量 : AudioManager.STREAM_MUSIC) 
第 二 个 参数 : 音量 大 小 

第 三 个 参数 :设置 一 个 或 者 多 个 标识 

2. getStreamVvolume(int streamType) 

作用 : 获取 当前 音量 大 小 

参数 : 获取 音量 大 小 的 类 型 

3. getStreamMaxVolume(int streamType) 

作用 : 获取 当前 音量 最 大 值 

参数 : 获取 音量 大 小 的 类 型 

Android OS 中 ， 如 果 去 按 手 机 上 调节 音量 的 按 


钮 ， 会 遇 到 两 种 情况 ， 一 种 是 调整 手机 本 身 的 铃声 音 
量 ， 另 外 一 种 是 调整 游戏 、 软 件 的 音乐 播放 的 音量 。 当前 音量 : 13 

在 游戏 中 的 时 候 ， 默 认 调 整 的 是 手机 的 铃声 音 当前 播放 的 时 间 ( 毫 秒 )/ 总 时 间 (毫秒 ) 
量 ， 只 有 游戏 中 有 声音 在 播放 的 时 候 ， 才 能 去 调整 游 37487/83539 
戏 的 音量 。 因 此 往 游戏 中 添加 音乐 时 ， 需 要 使 用 如 下 方向 键 中 间 按 钮 切换 暂停 /开始 
函数 方向 键 - 键 快 退 5 秒 


方向 键 ~ 键 快 进 5 秒 


MActivity.setVolumeControlStream(int streamType) 
方向 键 T 键 增加 音量 


作用 : 设置 控制 音量 的 类 型 
参数 : 音量 类 型 (AudioManager.STREAM_ 
MUSIC: 媒体 音量 ) 

在 熟 习 了 这 些 类 以 及 每 个 类 常用 的 函数 后 ， 就 实 
战 编写 一 个 简略 的 播放 器 ， 可 实现 快 进 、 快 退 、 播 
放 、 和 暂停、 调整 音量 大 小 的 操作 。 

新 建 项 目 “MediaPlayerProject”， 游 戏 框架 为 
SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代码 为 “4-15-1 
(MediaPlayer 音乐 ) ”。 首 先 看 看 项 目 效果 ， 如 图 4- 
55 所 示 。 图 4-55 MediaPlayer 项 目 效果 图 

修改 MySurfaceView 类 : 


// 声 明 音乐 的 状态 常量 

Private final int MEDIAPLAYER PAUSE = 0;// 暂 停 
Private final int MEDIAPLAYER PLAY = 1;// 播 放 中 
Private final int MEDIAPLAYER STOP = 2;// 停 止 
// 音 乐 的 当前 的 状态 


方向 键 | 键 减 小 音量 
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Private int mediaSate = 0; 
/ /声明 一 个 音乐 播放 器 

private MediaPlayer mediaPlayer; 
// 当 前 音乐 播放 的 时 间 点 
Private int currentTime; 
// 当 前 音乐 的 总 时 间 

Private int musicMaxTime; 
// 当 前 音乐 的 音量 大 小 

Private int currentVol; 

// 快 进 、 快 退 时 间 戳 

Private int setTime = 5000; 
// 播 放 器 管理 类 


Private AudioManager am; 


视图 初始 化 : 


public void surfaceCreated (SurfaceHolder holder) { 


/7 实例 音乐 播放 器 


mediaPlayer = MediaPlayer.create(context, R.raw.bgmusic); 
// 设 置 循环 播放 

mediaPlayer.setLooping(true) ; // 设 置 循环 播放 

// 获 取 音 乐 文件 的 总 时 间 

musicMaxTime = mediaPlayer.getDuration () 

// 实 例 管理 类 


am= (AudioManager)MainRActivity.instance.getSystemSerVvice (Co 
ntext .AUDIO SERVICE) ; 
// 设 置 当 前 调整 音量 大 小 只 是 针对 媒体 音乐 进行 调整 
MainActivity.instance.setVolumeControlStream(AudioManager. 
STREAM MUSIC); 


绘图 函数 : 


Public void myDraw () { 


canvas.drawColor (Color. WHITE); 
paint.setColor (Color.RED); 
paint.setTextSize(15); 
canvas.drawText ("当前 音量 : " + currentVol, 50, 40, paint); 
canvas.drawText ("当前 播放 的 时 间 (毫秒 ) /总 时 间 (毫秒 ) "，50，70， 
paint); 
canvas .drawText (currentTime + "/" + musicMaxTime, 100, 100, paint); 
canvas.drawText ("方向 键 中 间 按 钮 切换 暂停 /开始 "，50，130， 
paint); 
canvas.drawText ("方向 键 . 键 快 退 " + setTime / 1000 + " 秒 "，50， 
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160, paint); 
canvas 
1907 paint)}y 
canvas 


.drawText ("方向 键 - 键 快 进 " + setTime / 1000 + 


立 量 wm 


Canvas [4 


.drawText ("方向 键 ! 键 减 小 


因为 音乐 播放 的 当前 音量 、 当 前 时 间 是 随时 发 生变 化 的 ， 所 以 
得 到 ， 以 确保 是 最 新 值 。 
逻辑 函数 : 
Private void logic() { 
if (mediaPlayer != null) { 
// 获 取 当前 音乐 播放 的 时 间 


currentTime 


// 获 取 当 前 的 音量 值 


第 4 章 ”游戏 开发 基础 


各 ns DO 


.drawText(" 方 向 键 1 键 增加 音量 "，50，220，Paint) ; 
507F 2507 paint)s 


应 该 在 逻辑 函数 中 不 断 的 


mediaPlayer.getCurrentPosition(); 


currentVol = am.getStreamVolume (AudioManager.STREAM MUSIC); 


} else { 
currentTime 


0; 


实体 按键 监听 函数 : 


public boolean onKeyDown (int keyCode, KeyEvent event) 
// 导 航 中 键 播放 /暂停 操作 
if (keyCode KeyEvent .KEYCODE DPAD CENTER) { 
try { 
switch (mediaSate) { 
// 当 前 处 于 播放 的 状态 
Case MEDIAPLAYER PLAY: 
mediaPlayer .pause(); 
mediaSate = MEDIAPLAYER PAUSE; 
break; 
// 当 前 处 于 暂停 的 状态 
Case MEDIAPLAYER PAUSE: 
mediaPlayer.start (); 
mediaSate = MEDIAPLAYER PLAY; 
break; 
// 当 前 处 于 停止 的 状态 
Case MEDIAPLAYER STOP: 
if (mediaPlayer != null) { 
mediaPlayer .pause (); 
mediaPlayer .stop(); 
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mediaPlayer.prepare(); 
mediaPlayer.start (); 
mediaSate = MEDIAPLAYER PLAY; 
break; 
上 
} catch (IllegalStateException e) { 
// TODO Auto-generated catch block 
e.printStackTrace (); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace (); 


} 
// 导 航 上 键 调整 音乐 播放 声音 变 大 
} else if (keyCode == KeyEvent.KEYCODE DPAD UP) { 
am.SetStreamVolume (AudioManager. STREAM MUSIC, currentVol + 1, 
AudioManager .FLAG PLAY SOUND); 
// 导 航 下 键 调整 音乐 播放 声音 变 小 
} else if (keyCode == KeyEvent.KEYCODE DPAD DOWN) { 
am.SetStreamVolume (AudioManager. STREAM MUSIC, currentVol - 1, 
AudioManager .FLAG PLAY SOUND); 
// 导 航 左 键 调整 音乐 播放 时 间 倒退 五 秒 
} else if (keyCode == KeyEvent.KEYCODE DPAD LEFT) { 
if (currentTime - setTime <= 0) { 
mediaPlayer .seekTo (0); 
} else { 
mediapPlayer.seekTo (currentTime - setTime); 


} 
// 导 航 右键 调整 音乐 播放 时 间 快 进 五 秒 
} else if (keyCode == KeyEvent.KEYCODE DPAD RIGHT) { 
if (currentTime + setTime >= musicMaxTime) { 
mediaPlayer .seekTo (musicMaxTime); 
} else { 
mediaPlayer.seekTo(currentTime + setTime); 
’ 
return super.onKeyDown (keyCode, event); 


MediaPlayer 的 使 用 很 简单 。 创 建 一 个 实例 ， 然 后 调用 prepare() 准 备 函 数 ， 之 后 就 可 以 播 
放 音 乐 了 。 除 了 对 MediaPlayer 常用 的 操作 外 ，Android 还 提供 了 一 个 接口 : 


MediaPlayer.OnCompletionListener 


必须 重 写 一 个 抽象 函数 : 
M onCompletion (MediaPlayer arg0) 
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作用 : 音乐 播放 完毕 会 响应 此 函数 

参数 ， 完 成 音乐 播放 的 MediaPlayer 实例 
加 将 需要 的 MediaPlayer 实例 绑 定 在 完成 监听 器 上 : 
setOnCompletionListener (OnCompletionListener listener) 


这 个 监听 音乐 播放 是 否 完成 的 监听 器 ， 只 能 针对 音乐 只 播放 一 次 的 情况 进行 监听 。 也 
就 是 说 ， 如 果 设 置 了 音乐 循环 播放 ， 那 么 监听 器 永远 都 不 会 监听 到 音乐 是 否 播放 完成 ! 


4.15.2 SoundPool 

除了 MediaPlayer 能 播放 音乐 外 ，SoundPool 也 能 播放 一 些 音乐 文件 ， 它 们 之 间 最 大 的 
别 是 SoundPool 只 能 播放 小 的 文件 ， 至 于 更 详细 的 区 别 后 文 再 进行 讲解 。 

SoundPool 类 的 构造 函数 如 下 : 


x 


‘& SoundPool (int maxStreams, int streamType, int srcQuality) 
作用 : 实例 化 一 个 SoundPool 实例 
第 一 个 参数 ， 允许 同 时 播放 的 声音 最 大 值 
第 二 个 参数 ， 声 音 类 型 
第 三 个 参数 ， 声 音 的 品 
SoundPool 类 中 常用 的 函数 如 下 : 
M int load (Context context, int resId, int priority ) 
作用 : 加 载 音乐 文件 ， 返 回音 乐 ID (音乐 流 文件 数据 》 
第 一 个 参数 ，Context 实例 
第 二 个 参数 : 音乐 文件 Id 
第 三 个 参数 :标识 优先 考虑 的 声音 。 目 前 使 用 没有 任何 效果 ， 只 是 具备 了 兼容 性 价值 
M int play (int soundID, float leftVolume, float rightVolume, int priority, int loop, float rate ) 
作用 : 音乐 播放 ， 播 放 失 败 返 回 0， 正 常 播放 返回 非 0 值 
第 一 个 参数 ， 加载 后 得 到 的 音乐 文件 ID 
第 二 个 参数 ， 音量 的 左 声 道 ， 范 围 : 0.0~1.0 
第 三 个 参数 :音量 的 右 声 道 ， 范 围 : 0.0~1.0 
第 四 个 参数 : 音乐 流 的 优先 级 ，0 是 最 低 优 先 级 
第 五 个 参数 : 音乐 的 播放 次 数 ，-1 表示 无 限 循环 ，0 表 示 正 常 一 次 ， 大 于 0 则 表示 循环 次 数 
第 六 个 参数 ， 播放 速率 ， 取 值 范围 .0.5~2.0，1.0 表示 正常 播放 
M pause (int streamID) 
作用 : 暂停 音乐 播放 
参数 :音乐 文件 加 载 后 的 流 ID 
M stop (int streamID) 
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作用 : 结束 音乐 播放 
参数 : 音乐 文件 加 载 后 的 流 ID 

M release() 
作用 : 释放 SoundPool 的 资源 

M setLoop (int streamID, int loop) 
作用 : 设置 循环 次 数 
第 一 个 参数 :音乐 文件 加 载 后 的 流 ID 
第 二 个 参数 : 循环 次 数 

M setRate (int streamID, float rate) 
作用 : 设置 播放 速率 
第 一 个 参数 :音乐 文件 加 载 后 的 流 ID 
第 二 个 参数 : 速率 值 

M setVolume (int streamID, float leftVolume, float rightVolume ) 
作用 : 设置 音量 大 小 
第 一 个 参数 :音乐 文件 加 载 后 的 流 ID 
第 二 个 参数 : 左 声 道 音 量 
第 三 个 参数 : 右 声 道 音 量 

Q setPriority (int streamID, int priority ) 
作用 : 设置 流 的 优先 级 
第 一 个 参数 :音乐 文件 加 载 后 的 流 ID 
第 二 个 参数 :优先 级 值 


下 面 就 通过 播放 音乐 文件 的 实例 来 详细 讲解 如 何 使 用 SoundPool。 新 建 项 目 
“SoundPoolProject”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代码 为 “4-15-2 
(SoundPool 音 效 ) ”。 首 先导 入 音乐 文件 ， 如 图 4-56 所 示 。 


4 双 res 
EE drawable-hdpi 
EE drawable-ldpi 
ES drawable-mdpi 


EE layout 
4 BE raw 
转 himi_long.mid 
转 himi_short.ogg 


图 4-56 ”声音 文件 
两 个 音乐 文件 分 别 为 : himi_long.mid， 音 乐 长 度 42 秒 ; himi_short.ogg， 音 乐 长 度 1 秒 。 
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修改 MySurfaceVIew 类 : 


// 声 明 SoundPool 

Private SoundPool sp; 

// 记 录 长 音乐 文件 id 

Private int soundId long; 
// 记 录 断 短 音乐 文件 id 


Private int soundId short; 


构造 函数 : 


public MySurfaceView (Context context) { 


// 实 例 SoundPool 播放 器 

sp = new SoundPool (4, AudioManager .STREAM MUSIC, 100); 
A/ 加载 音乐 文件 获取 其 数据 ID 

soundId long = sp.load(context, R.raw.himi long, 1); 
// 加 载 音乐 文件 获取 其 数据 ID 


soundId short = sp.load(context, R.raw.himi short, 1); 


绘图 函数 : 


public void myDraw() { 


paint.setColor (Color .RED) ; 

paint .setTextSize(15) ; 

canvas .drawText (" 点 击 导 航 键 的 上 键 : 播放 断 音效 "， 50， 50，Ppaint) 
canvas .drawText (" 点 击 导航 键 的 下 键 : 播放 长 音效 "，50，80，Ppaint) ; 


实体 按键 监听 函数 : 


Pub1lic boolean onKeyDown (int keyCode, KeyEvent event) { 
if (keyCode == KeyEvent .KEYCODE DPAD UP) 
sp.play(soundId long, 1f, 1f, 0, 0, 1); 
else if (keyCode == KeyEvent.KEYCODE DPAD DOWN) 
sp.play(soundId short, 2, 2, 0, 0, 1); 
return super.onKeyDown (keyCode, event); 


项 目 效 果 如 图 4-57 所 示 。 
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点 击 导航 键 的 上 键 : 播放 短 音效 
点 击 导航 键 的 下 键 : 播放 长 音效 


图 4-57 SoundPool 项 目 截图 
整个 项 目的 流程 很 简单 ， 通 过 判断 用 户 的 按键 ， 播 放 不 同 的 音乐 文件 ， 但 是 运行 项 目 时 
会 报 出 如 图 4-58 所 示 的 错误 : 
OOOOOl+H-| 国 ”°0 


Message 

Heap size overflow! req 
Heap size overflow! req 
Heap size overflow! req 
Heap size overflow! req 
Heap size overflow! req 
Heap size overflow! req 
Heap size overflow! req 
Heap size overflow! req 


1050624, 1048576 
1050624 1048576 
1050624， 1048576 
1050624. 1048576 
1050624. 1048576 
1050624. 1048576 
1050624. 1048576 
1050624. 1048576 
Heap size overflow! req 1050624. 1048576 
Heap size overflow! req 1050624. 1048576 
Heap size overflow! req 1050624. 1048576 


图 4-58 ”异常 截图 


萌 误 对 应 的 程序 代码 是 加 载 长 音乐 文件 生成 其 数据 ID 一 行 ， 出 现 此 错误 的 原因 如 下 : 

利用 SoundPool 播放 音乐 文件 ， 首 先 都 会 对 需要 播放 的 音乐 文件 通过 函数 int load 
(Context context, int resId, int priority) 进行 加 载 ， 并 且 生 成 对 应 的 音乐 数据 ID; 其 生成 的 数 
据 ID (int 值 ) 就 是 整个 音乐 文件 的 所 有 数据 ， 而 当前 项 目的 长 音乐 文件 himi_long.mid， 音 
乐 长 度 有 42 秒 ， 其 中 的 音乐 流 数据 文件 也 远 远 超 过 了 int 的 最 大 值 ， 所 以 当 程 序 加 载 此 音乐 
文件 生成 对 应 的 数据 ID 时 ， 会 报 超过 最 大 值 的 异常 。 

虽然 出 现 此 异常 ， 但 是 还 不 会 导致 整个 程序 崩溃 ， 只 是 当 再 播放 长 的 音乐 文件 时 ， 会 发 
现 播放 的 时 间 很 得， 明显 的 感觉 到 像 被 剪 切 了 一 样 ， 这 也 证 实 了 SoundPool 只 能 存放 1M 大 
小 的 音乐 数据 。 
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4.15.3 MediaPlayer 与 SoundPool 优 劣 分 析 


1. 使 用 MediaPlayer 的 优 缺 点 


(1) 缺点 

资源 占用 量 较 高 、 延 迟 时 间 较 长 、 不 支持 多 个 音频 同时 播放 等 。 

除 此 之 外 使 用 MediaPlayer 进行 播放 音乐 时 ， 尤 其 是 在 快速 连续 播放 声音 〈 比 如 连续 猛 
点 按钮 ) 时 ， 会 非常 明显 的 出 现 1~3 秒 左 右 的 延迟 ; 当然 此 问题 可 以 使 用 
MediaPlayer.seekTo() 这 个 方法 来 解决 。 

(2) 优点 

支持 很 大 的 音乐 文件 播放 ， 而 且 不 会 同 SoundPool 一 样 需要 加 载 准备 一 段 时 间 ， 
MediaPlayer 能 及 时 播放 音乐 。 


2. 使 用 SoundPool 的 优 缺 点 


(1) 缺点 

@ 最 大 只 能 申请 1M 的 内 存 空间 ， 这 就 意味 着 用 户 只 能 使 用 一 些 很 短 的 声音 片段 ， 而 不 
能 用 它 来 播放 歌曲 或 者 游戏 背景 音乐 

@SoundPool 提供 了 pause 和 stop 方法 ， 但 建议 最 好 不 要 轻易 使 用 这 些 方法 ， 因 为 使 用 它 
们 可 能 会 导致 程序 莫名 其 妙 的 终止。 

图 使 用 SoundPool 时 音频 格式 建议 使 用 OGG 格式 。 如 果 使 用 WAV 格式 的 音频 文件 ， 在 
播放 的 情况 下 有 时 会 出 现 异 常 关 闭 的 情况 。 

@ 在 使 用 SoundPool 播放 音乐 文件 的 时 候 ， 如 果 在 构造 中 就 调用 播放 函数 进行 播放 音 
乐 ， 其 效果 则 是 没有 声音 ! 不 是 因为 函数 没有 执行 ， 而 是 SoundPool 需要 加 载 准备 时 间 ! 当 
然 这 个 准备 时 间 也 很 短 ， 不 会 影响 使 用 ， 只 是 程序 一 运行 播放 刚 开始 会 没有 声音 婴 了 。 

(2) 优点 

支持 多 个 音乐 文件 同时 播放 。 

通过 以 上 的 分 析 可 以 明显 的 知道 ， 在 Android 游戏 开发 中 ， 游 戏 背 景 音乐 使 用 
MediaPlayer 肯定 比 使 用 SoundPool 要 合适 ， 而 游戏 音效 的 播放 采用 SoundPool 则 更 好 ， 毕 竟 
游戏 中 肯定 会 出 现 多 个 音效 同时 进行 播放 的 情况 。 


人 .| 0 游戏 数据 存储 


对 于 数据 的 存储 ，Android 提供 了 4 种 保存 方式 。 
(1) SharedPreference 


此 方式 适用 于 简单 数据 的 保存 ， 文 如 其 名 ， 属 于 配置 性 质 的 保存 ， 不 适合 数据 比较 大 的 
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情况 ， 默 认 存放 在 手机 内 存 里 。 

(2) FlleInputStream/FileOutputStream 

此 方式 比较 适合 游戏 的 保存 和 使 用 ， 流 文件 数据 存储 可 以 保存 较 大 的 数据 ， 而 且 通 过 此 
方式 不 仅 能 把 数据 存储 在 手机 内 存 中 ， 也 能 将 数据 保存 到 手机 的 SDcard 中 。 

(3) SQLite 

此 方式 也 适合 游戏 的 保存 和 使 用 ， 不 仅 可 以 保存 较 大 的 数据 ， 而 且 可 以 将 自己 的 数据 存 
储 到 文件 系统 或 者 数据 库 当中 ， 如 SQLite 数据 库 ， 也 能 将 数据 保存 到 SDcard 中 。 

(4) ContentProvider 

此 方式 不 推荐 用 于 游戏 保存 ， 虽 然 此 方式 能 存储 较 大 数据 ， 还 支持 多 个 程序 之 间 的 数据 
进行 交换 ， 但 由 于 游戏 中 基本 就 不 可 能 去 访问 外 部 应 用 的 数据 ， 所 以 对 于 此 方式 在 本 书 中 就 
不 予 讲解 ， 有 兴趣 的 可 以 自行 查阅 相关 书籍 和 资料 。 


4.16.1 SharedPreference 
SharedPreference 实例 是 通过 Context 对 象 得 到 的 : 
M Context.getSharedPreferences (String name, int mode) 
作用 : 利用 Context 对 象 获取 一 个 SharedPreference 实例 
第 一 个 参数 : 生成 保存 记录 的 文件 名 
第 二 个 参数 : 操作 模式 
SharedPreference 实例 的 操作 模式 一 共有 四 种 : 


e@ Context.MODE PRIVATE: 新 内 容 覆 盖 原 内 容 。 

e Context.MODE_APPEND: 新 内 容 追 加 到 原 内 容 后 。 

e ContextMODE WORLD READABLE: 允许 其 他 应 用 程序 读 取 。 

e Context.MODE_WORLD_WRITEABLE: 允许 其 他 应 用 程序 写 入 ， 会 覆盖 原 数据 。 


SharedPreference 常用 函数 : 


getFloat (String key, float defValue ) 
getInt (String key, int defValue ) 
getLong ( String key, long defValue ) 
getString (String key, String defValue ) 


getBoolean (String key, boolean defValue ) 


SharedPreference 常用 函数 的 作用 是 获取 存储 文件 中 的 值 ， 根 据 方法 不 同 获取 不 同 对 应 的 
类 型 值 ， 一 般 第 一 个 参数 为 索引 Key 值 ， 第 二 个 参数 为 在 存储 文件 中 找 不 到 对 应 Value 值 
时 ， 默 认 的 返回 值 。 其 实 SharedPreference 的 存储 数据 和 读 取 的 方式 都 类 似 哈 希 表 ， 这 里 第 
二 个 参数 需要 传 入 一 个 默认 返回 值 ， 这 也 避免 了 找 不 到 对 应 Key 的 Value 值 时 ， 出 现 返回 异 
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以 上 是 对 存储 文件 中 进行 读 取 数据 的 一 些 常用 操作 函数 ， 当 然 对 应 的 肯定 也 有 保存 数据 
时 的 这 些 类 型 函数 。 但 是 在 对 存储 文件 的 数据 进行 存 入 操作 时 ， 首 先 需 要 利用 
SharedPreference 实例 得 到 一 个 编辑 对 象 : 


SharedPreferences.Editor edit (); 


得 到 编辑 对 象 之 后 就 可 以 对 SharedPreference 中 的 数据 进行 操作 。 


SharedPreferences.Editor.putFloat ( arg0, argl ) 
SharedPreferences.Editor.putInt (arg0, argl ) 

SharedPreferences.Editor.putLong (arg0, argl ) 
SharedPreferences.Editor.putString (arg0, argl ) 


SharedPreferences.Editor.putBoolean (arg0, argl ) 


以 上 方法 的 作用 是 对 存储 的 数据 进行 操作 〈 写 入 、 保 存 ) ， 其 中 的 第 一 个 参数 是 需要 保 
存 数 据 的 Key 值 索 引 ， 第 二 个 参数 是 需要 保存 的 数据 。 

到 此 虽然 对 SharedPreferences 中 的 数据 进行 了 修改 或 者 保存 ， 但 是 还 没有 真正 的 写 入 到 
SharedPreferences 生成 的 存储 文件 中 ， 所 以 还 需要 将 其 编辑 的 数据 进行 提交 方 可 完成 存 入 和 
修改 : 


SharedPreferences .Editor.commit() 


当 提 交 之 后 ， 整 个 保存 的 步骤 才 真 正 的 结束 ， 在 使 用 SharedPreferences 进行 存储 数据 
时 ， 务 必 不 能 忘记 最 后 一 步 的 提交 ! 

除 此 之 外 ， 如 果 想 删除 存储 文件 中 的 一 条 数据 ， 则 可 以 使 用 以 下 函数 : 
SharedPreferences.Editor.clear () 

为 了 让 大 家 熟 习 在 游戏 开发 中 如 何 嵌 入 游戏 存储 ， 下 面 简单 写 一 个 小 游戏 ， 然 后 通过 
SharedPreference 为 游戏 添加 保存 功能 。 小 游戏 很 简单 ， 绘 制 9 个 方 格 ， 初 始 在 第 一 格子 有 个 
圆 形 ， 用 户 可 以 通过 手机 实体 的 左右 导航 键 移 动 圆 形 ， 上 键 代 表 保 存 游戏 状态 ， 下 键 代 表 读 

新 建 项 目 “SharedPreferenceProject”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 
源 代 码 为 “4-16-1 (游戏 保存 之 SharedPreference) ”。 

修改 MySurfaceView 如 下 : 


// 记 录 当 前 圆 形 所 在 九宫 格 的 位 置 下 标 


Private int creentTileIndex; 


绘图 函数 : 


Public void myDraw() { 
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canvas.drawColor (Color .WHITE); 
paint.setStyle (Style. STROKE); 
// 绘 制 九 宫 格 (将 屏幕 九 等 份 ) 
// 得 到 每 个 方 格 的 宽 高 
int tilemw = screenW / 3; 
int tileH = screenH / 3; 
Lor (dnEti sn Le 
or (dot = OF EST 
canvas.drawRect (i * tileW, j * tileH, (i + 1)* tilew, 
(FEI Le PS 
| 
} 
paint.setStyle (Style. FILL); 
// 根 据 得 到 的 圆 形 下 标 位 置 进行 绘制 相应 的 方 格 中 
canvas .drawCircle(creentTileIndex $% 3 * tileW + tilew / 2, 
creentTileIndex / 3 * tileH + tileH / 2, 30, paint); 
// 操 作 说 明 
canvas.drawText ("上 键 : 保存 游戏 "，0，20,，paint); 
canvas.drawText ("下 键 : 读 取 游 戏 "，110，20,，paint); 
canvas .drawText ("左右 键 : 移动 圆 形 "，215，20，Ppaint) 


到 此 小 游戏 完成 ， 为 保存 数据 做 好 了 准备 。 项 目 运行 效果 如 图 4-59 所 示 。 
接 下 来 ， 对 圆 形 添加 移动 功能 以 及 对 游戏 进行 添加 “存储 和 读 取 ” 功 能 。 
首先 添加 一 个 成 员 变 量 : 


Private SharedPreferences sp; 


然后 修改 构造 函数 : 


Pub1lic MySurfaceView (Context context) { 


// 通 过 Context 获取 SharedPreference 实例 
sp = context.getSharedPreferences ("SaveName", 
Context .MODE PRIVATE); 

// 每 次 程序 运行 时 获取 圆 形 的 下 标 
int tempIndex = sp.getInt ("CirCleIndex", -1); 
// 判 定 如 果 返 回 -1 说 明 没有 找到 ， 就 不 对 当前 记录 圆 形 的 变量 进行 赋值 
if (tempIndex != -1) { 

creentTileIndex = tempIndex; 


} 
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图 4-59 项 目 截图 


在 程序 刚 启动 时 就 应 该 读 取 上 次 运行 所 在 的 下 标 值 ， 如 果 取 不 到 值 ， 说 明之 前 没有 保存 
过 ， 那 么 将 不 赋值 给 当前 程序 的 圆 形 下 标 变量 。 
最 后 就 是 添加 实体 按键 处 理 : 


public boolean onKeyDown (int keyCode, KeyEvent event) { 
// 上 键 保存 游戏 状态 
if (keyCode == KeyEvent.KEYCODE DPAD UP) { 
sp.edit() .putInt ("CirCleIndex", creentTileIndex) .commit(); 
// 下 键 读 取 游 戏 状态 
} else if (keyCode == KeyEvent.KEYCODE DPAD DOWN) { 
int tempIndex = sp.getInt ("CirCleIndex", -1); 
if (tempIndex != -1) { 
creentTileIndex = tempIndex; 


} 
// 圆 形 的 移动 
} else if (keyCode == KeyEvent.KEYCODE DPAD LEFT) { 
if (creentTileIndex > 0) { 
creentTileIndex -= 1; 
} 
} else if (keyCode == KeyEvent.KEYCODE DPAD RIGHT) { 
if (creentTileIndex < 8) { 
creentTileIndex += 1; 
} 
} 
return super.onKeyDown (keyCode, event); 


下 面 运行 项 目 ， 并 且 将 圆 形 移动 到 中 间 格 中 ， 单 击 上 键 保存 其 位 置 ， 然 后 重新 运行 项 目 
观察 效果 ， 如 图 4-60 所 示 。 
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2) 移动 圆 形 然后 点 


1) 首次 运行 程序 击 上 键 保 存 其 状态 3) 重新 运行 程序 


下 键 : 读 取 游戏 外 下 键 : 恋 取 尖 戏 ;移动 加 形 和: 保存 下 键 : 读 加 游戏 


4-60 SharedPreference 存储 


4.16.2 ” 流 文件 存储 


为 了 便于 讲解 ， 仍 然 利用 上 一 小 节 的 小 游戏 存储 代码 ， 但 是 去 除 SharedPreference 存储 
部 分 ， 这 里 改 用 流 文件 形式 进行 保存 ， 项 目 对 应 的 源 代码 为 “4-16-2 游戏 保存 之 
Stream) ”。 本 项 目 中 ， 需 要 修改 的 只 有 游戏 “保存 ”与 “ 读 取 ” 的 操作 。 
实体 按键 监听 函数 : 
Public boolean onKeyDown (int keyCode, KeyEvent event) { 
// 用 到 的 读 出 、 写 入 流 
FileOutputStream fos = null; 
FileInputStream fis = null; 
DataOutputStream dos = null; 
DataInputStream dis = null; 


// 上 键 保存 游戏 状态 
if (keyCode == KeyEvent .KEYCODE DPAD UP) { 
try { 


// 利 用 Activity 实例 打开 流 文件 得 到 一 个 写 入 流 
fos = MainActivity.instance.openFileOutput 
("save.himi", Context.MODE PRIVATE); 

// 将 写 入 流 封装 在 数据 写 入 流 中 
dos = new DataOutputStream (fos); 
// 写 入 一 个 int 类 型 (将 圆 形 所 在 格子 的 下 标 写 入 流 文件 中 ) 
dos.writeInt (creentTileIndex); 

} catch (FileNotFoundException e) { 
// TODO Auto-generated catch block 
e.printstackTrace(); 
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} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printstackTrace(); 
} finally { 
// 即 使 保存 时 发 生 异常 ， 也 要 关闭 流 
try { 
if (fos != null) 
fos.close(); 
if (dos != null) 
dos.close(); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace (); 
} 
// 下 键 读 取 游戏 状态 
} else if (keyCode == KeyEvent.KEYCODE DPAD DOWN) { 
try { 
if (MainActivity.instance.openFileInput 
("save.himi") != null) { 
ty { 
// 利 用 Activity 实例 打开 流 文件 得 到 一 个 读 入 流 
fis = MainActivity.instance. 
openFileInput ("save.himi"); 
// 将 读 入 流 封 装 在 数据 读 入 流 中 
dis = new DataInputStream (fis); 
// 读 出 一 个 Int 类 型 赋值 与 圆 形 所 在 格子 的 下 标 
creentTileIndex = dis.readInt (); 
} catch (FileNotFoundException e) { 
// TODO Auto-generated catch block 
e.pPrintStackTrace() 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printSstackTrace (); 
} finally { 
// 即 使 读 取 时 发 生 异 常 ， 也 要 关闭 流 
try { 
if (fis != null) 
fis.close(); 
if (dis != null) 
dis.close(); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printstackTrace (); 
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} 

} catch (FileNotFoundException e) { 
// TODO Auto-generated catch block 
e.printStackTrace (); 


} 
// 圆 形 的 移动 
} else if (keyCode == KeyEvent.KEYCODE DPAD LEFT) { 
if (creentTileIndex > 0) { 
creentTileIndex -= 1; 


UL 
} else if (keyCode == KeyEvent.KEYCODE DPAD RIGHT) { 


if (creentTileIndex < 8) { 
creentTileIndex += 1; 
} 


return super.onKeyDown (keyCode, event); 


不 管 是 读 入 还 是 写 入 ， 都 通过 Activity 打开 流 文件 得 到 输入 输出 流 。 当 需要 写 入 流 文件 
时 ， 如 果 打 开 的 流 文 件 不 存在 ， 那 么 Android 会 自动 生成 对 应 的 流 文件 ， 而 当 需 要 读 入 流 文 
件 时 ， 首 先 应 该 判定 流 文件 是 否 存 在 ， 一 旦 流 文件 不 存在 ， 就 会 抛 出 异常 。 
这 里 流 形式 的 保存 操作 比较 简单 ， 需 要 注意 的 是 : 
e 读 流 时 ， 一 定 要 记得 先 判 断 是 否 存 在 需要 操作 的 流 文件 ; 
@ 写 入 和 读 入 的 数据 类 型 要 配对 ， 顺 序 也 不 能 错 ; 例如 : 写 入 时 ， 先 写 入 了 一 个 
boolean 值 ， 然 后 又 写 入 了 一 个 Int 值 ; 那么 读 入 时 ， 也 应 该 先 读 boolean 类 型 ， 然 后 
再 读 Int 类 型 ; 
8 流 一 旦 打开 一 定 要 关闭 ， 为 了 避免 流 操作 出 现 异 常 ， 需 确保 正常 关闭 流 ， 应 该 将 关闭 
操作 写 在 finally 语句 中 ; 
e file 流 使 用 Data 流 进 行 了 封装 ， 这 样 做 的 原因 是 可 以 获得 更 多 的 操作 方式 ， 便 于 对 数 
据 的 处 理 。 
以 上 是 使 用 流 文件 保存 的 方式 ， 但 是 也 只 是 将 保存 后 的 流 文件 默认 放 在 了 系统 内 存 里 。 
- 般 游戏 的 数据 可 能 会 有 很 多 ， 所 以 不 应 该 放 在 手机 内 存 中 ， 而 是 放 在 SDCard 中 ， 这 样 就 
不 用 担心 系统 因 游 戏 保存 的 数据 过 多 导致 内 存 不 足 等 问题 。 
将 流 文件 保存 在 SDCard 中 的 详细 步骤 如 下 : 
(1) 声明 读 入 权限 : 
Android 中 的 一 些 操作 ， 比 如 : 读 取 通 讯 录 信息 、 发 送 短 信 、 使 用 联网 、GPRS 等 功能 
需要 在 项 目 AndroidManifest.xml 中 声明 使 用 权限 ， 然 后 才 可 正常 使 用 其 功能 。 
当然 在 很 多 时 候 ， 是 不 知道 是 否 需 要 声明 添加 权限 的 ， 其 实 这 个 也 不 用 知道 ， 因 为 如 果 
用 到 这 些 需要 声明 权限 的 功能 ， 且 恰好 没有 声明 的 情况 下 ， 在 LogCat 中 是 会 报 异 常 的 ， 其 异 
常 则 提醒 需要 添加 对 应 的 权限 。 
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写 入 权限 如 下 : 


<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE"/> 


(2) 创建 目录 和 存储 文件 
使 用 SDCard 的 方式 进行 存储 数据 ， 写 入 的 时 候 Android 不 会 跟 存储 系统 默认 路 径 那样 默 
认 生 成 存储 文件 ， 所 以 必须 自己 来 创建 ， 如 果 存 储 的 文件 有 自 定义 路 径 的 话 ， 那 么 这 个 路 径 
也 需要 手动 添加 。 
假定 存储 文件 在 SDCard 的 路 径 为 /sdcard/himi/save.himi。 
@ 首 先 需 要 创建 路 径 /sdcard/himi 
// 声 明 一 个 路 径 
File path = new File("/sdcard/himi"); 
if (!path.exists()) { 
path.mkdirs (); 
} 
M boolean File.exists() 
作用 : 判断 是 否 存 在 当前 目录 
返回 值 : 当 目录 存在 返回 true 
M boolean File.mkdirs() 
作用 : 创建 一 个 目录 
返回 值 : 当 创 建成 功 返回 true 


加 然后 创建 存储 文件 ， /sdcard/himi/save.himi 
// 声 明文 件 路 径 


File f = new File("/sdcard/himi/save.himi"); 
if (!f.exists()) {// 文件 存在 返回 true 
f.createNewFile() ;// 创建 一 个 文件 


) 
M boolean File.createNewFile() 
作用 : 创建 一 个 文件 
返回 值 : 创建 成 功 返回 true 
(3) 通过 加 载 指定 路 径 的 存储 文件 获取 输入 输出 流 
e 输入 流 : FileInputStream fis = new FileInputStream (File file ) ; 
e 输出 流 : FileOutputStream fos = new FileOutputStream (File file ) 。 
除 此 之 外 还 需要 知道 一 点 ， 因 为 有 时 手机 设备 并 没有 安装 SDCard， 或 者 当前 SDCard 处 
于 被 移 除 的 状态 时 ， 为 了 避免 这 两 种 情况 带 来 的 异常 ， 需 要 通过 下 面 方法 获取 当前 手机 设备 
SDCard 的 状态 : 
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M String Environment.getExternalStorageState() 
作用 : 获取 当前 SDCard 的 状态 
返回 值 : 当 SDCard 不 存在 时 ， 返 回 null; 
当 SDCard 处 于 移 除 状态 时 ， 返 回 “removed”; 
知道 这 些 之 后 ， 本 对 之 前 使 用 流 保存 数据 默认 保存 在 手机 内 存 里 的 方式 进行 添加 修改 ， 
使 之 在 默认 手机 设备 存在 SDCard 时 ， 保 存在 SDCard 中 ; 当 SDCard 不 存在 或 者 SDCard 正 
处 于 被 移 除 的 状态 时 ， 默 认 将 数据 保存 在 手机 内 存 中 。 
按键 监听 函数 修改 如 下 : 


T 


public boolean onKeyDown (int keyCode, KeyEvent event) { 


// 用 到 的 读 出 、 写 入 流 

FileOutputStream fos = null; 
FileInputStream fis = null; 
DataOutputStream dos = null; 
DataInputStream dis = null; 

// 上 键 保存 游戏 状态 

if (keyCode == KeyEvent.KEYCODE DPAD UP) { 


{ 
// 从 SDcard 中 写 入 数据 
// 试探 终端 是 否 有 sdcard! 并 且 探 测 SDCard 是 否 处 于 被 移 除 的 状态 
if (Environment .getExternalStorageState() != null 
&& !Environment .9etEBxternalStorageState () .equals ("removed")) { 
Log.v("Himi",，" 写 入 ， 有 SD 卡 "); 
File path = new File("/sdcard/himi");// 创建 目录 
File f=new File("/sdcard/himi/save.himi");// 创 建文 件 
if (!path.exists()) {// 目录 存在 返回 true 
path .mkdirs () ;// 创建 一 个 目录 
1 
if (!f.exists()) {// 文件 存在 返回 true 
f.createNewFile() ;// 创建 一 个 文件 
fos = new FileOutputStream(f);// 将 数据 存 入 sd 卡 中 
} else { 
/ /默认 系统 路 径 
// 利 用 Activity 实例 打开 流 文件 得 到 一 个 写 入 流 
fos = MainActivity.instance.openFileOutput ("save.himi", 
Context .MODE PRIVATE); 


上 
// 将 写 入 流 封 装 在 数据 写 入 流 中 
dos = new Data0utputStream (fos); 
// 写 入 一 个 int 类 型 (将 圆 形 所 在 格子 的 下 标 写 入 流 文件 中 ) 
dos.writeInt (creentTileIndex) 
} catch (FileNotFoundException e) { 
// TODO Auto-generated catch block 
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e.printstackTrace (); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printstackTrace(); 
} finally { 
// 即 使 保存 时 发 生 异常 ， 也 要 关闭 流 
try { 
if (fos != null) 
fos.close(); 
if (dos != null) 
dos.close(); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace (); 
} 


} 
// 下 键 读 取 游戏 状态 
} else if (keyCode == KeyEvent.KEYCODE DPAD DOWN) { 
boolean isHaveSDCard = false; 
// 从 spcard 中 读 取 数据 
// 试探 终端 是 否 有 sdcard! 并 且 探 测 SDCard 是 否 处 于 被 移 除 的 状态 
if (Environment .getExternalStorageState() != null 
&& !Environment .getExternalStorageState() .equals ("removed")) { 
Log.v("Himi",，" 读 取 ,， 有 SD 卡 "); 
isHaveSDCard = true; 


if (isHaveSDCard) { 
File path = new File("/sdcard/himi");// 创建 目录 
File f=new File("/sdcard/himi/save.himi");// 创 建文 件 
if (!path.exists()) {// 目录 存在 返回 true 
return false; 
} else { 
if (!f.exists()) {// 文件 存在 返回 true 
return false; 
} 
} 
fis = new FileInputStream(f) ;// 将 数据 存 入 sd 卡 中 
} else { 
if 
(MainActivity.instance.openFileInput ("save.himi") != 
null) { 
// 利 用 Activity 实例 打开 流 文件 得 到 一 个 读 入 流 
fis = MainActivity.instance.openFileInput 
("save.himi"); 
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下 
// 将 读 入 流 封装 在 数据 读 入 流 中 
dis = new DataInputStream(fis); 
// 读 出 一 个 Int 类 型 赋值 与 圆 形 所 在 格子 的 下 标 
creentTileIndex = dis.readInt() 
} catch (FileNotFoundException e) { 
// TODO Auto-generated catch block 
e.printStackTrace (); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace (); 
} finally { 
// 即 使 读 取 时 发 生 异常 ， 也 要 关闭 流 
try { 
if (fis != null) 
fis.close(); 
if (dis != null) 
dis.close(); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printSstackTrace (); 


4.16.3 SQLite 

SQLite 是 一 款 轻 量 级 数据 库 ， 它 的 设计 目的 是 用 于 嵌入 式 系统 ， 而 且 它 占用 的 系统 资源 
非常 少 ， 只 有 几 百 KB。 

SQLite 具有 如 下 特性 : 
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轻 量 级 。 使 用 SQLite 只 需要 带 一 个 动态 库 ， 就 可 以 享受 它 的 全 部 功能 ， 而 且 动态 库 
的 尺寸 相当 小 。 

独立 性 。SQLite 数据 库 的 核心 引擎 不 需要 依赖 第 三 方 软件 ， 也 不 需要 所 谓 的 “ 安 
灶 ” 。 

隔离 性 。SQLite 数据 库 中 所 有 的 信息 (比如 表 、 视 图 、 触 发 器 等 ) 都 包含 在 一 个 文件 
夹 内 ， 方 便 管理 和 维护 。 

跨 平台 。SQLite 目前 支持 大 部 分 操作 系统 ， 不 只 是 电脑 操作 系统 ， 在 众多 的 手机 系统 
中 也 是 能 够 运行 的 ， 比 如 : Android。 

多 语言 接口 。SQLite 数据 库 支 持 多 语言 编程 接口 。 


e 安全 性 。SQLite 数据 库 通 过 数据 库 级 上 的 独占 性 和 共享 锁 来 实现 独立 事务 处 理 。 这 意 
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味 着 多 个 进程 可 以 在 同一 时 间 从 同一 数据 库 读 取 数 据 ， 但 只 有 一 个 可 以 写 入 数据 。 


此 种 存储 方式 比较 灵活 ， 而 且 更 加 适合 大 数据 量 游戏 的 存储 ， 当 然 利 用 轻 量 级 数据 库 
SQLite 也 可 以 存储 到 SDCard 中 。 

由 于 SQLite 存 储 方式 涉及 到 SQL 语言 的 基础 知识 ， 比 如 一 些 基 础 的 对 数据 库 的 操作 、 删 
除 、 添 加 、 修 改 等 语句 。 对 于 没有 数据 库 基础 的 读者 ， 这 里 讲解 的 太 过 简单 ， 如 果 对 SQLite 
感 兴趣 的 话 ， 可 以 参考 其 他 资料 与 书籍 ， 也 可 以 登录 作者 的 博客 进行 学 习 。 

SQLite 存 储 的 内 容 可 以 参考 以 下 地 址 : 

http://blog.csdn.net/xiaominghimi/archive/2011/01/04/6114629.aspx 


4.1/ 本 章 小 地 


本 章 介绍 了 Android 游戏 开发 的 基础 知识 ， 具 体内 容 包括 Android 游戏 开发 中 常用 的 三 
种 视图 ，View、surface View 游戏 框架 及 区 别 ，Canvas 画布 ，Paint 画笔 ，Bitmap 位 图 的 演 染 
与 操作 ， 前 切 区 域 ， 动 画 ， 游 戏 适 屏 的 简 述 与 作用 ， 让 游戏 主角 动 起 来 ， 碰 撞 检 测 ， 游 戏 音 
乐 与 音效 ， 游 戏 数据 存储 等 。 这 些 内 容 是 Android 游戏 开发 人 员 必 须 掌握 的 。 
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从 本 章节 可 以 学 习 到 : 


学 项 目前 的 准备 工作 

学 划分 游戏 状态 

学 游戏 初始 化 菜单 界面 ) 
学 游戏 界面 

学” 游戏 胜利 与 结束 界面 
学 游戏 细节 处 理 
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通过 上 一 章 对 Android 平台 游戏 开发 基础 的 学 习 ， 大 家 应 该 对 游戏 视图 的 框架 、 基 本 的 
绘图 、 图 形 的 泻 染 、 游 戏 音效 、 背 景 音乐 以 及 游戏 存储 都 有 一 定 的 掌握 ; 虽然 这 些 很 基础 ， 
但 足够 用 来 独立 开发 游戏 应 用 。 

本 章 主要 通过 一 个 “飞行 射击 ”类 型 的 实战 项 目 ， 让 大 家 一 方面 掌握 游戏 开发 的 流程 ， 
深入 学 习 在 一 款 游 戏 中 模块 之 间 是 如 何 相辅相成 并 完成 一 款 游戏 的 。 另 一 方面 通过 实战 项 目 
发 现 一 些 不 经 意 的 细节 问题 及 编程 缺陷 。 


项 目前 的 准备 工作 


新 建 项 目 “PlaneGame”， 游 戏 框架 为 SurfaceView 游戏 框架 ,项目 对 应 的 源 代码 为 “5- 
1 (飞行 射击 游戏 实战 ) ”。 项 目 使 用 的 图 片 资源 如 图 5-1 所 示 。 


网 320*480 油 伐 夫 谎 和 320*480 放 懂 胜利 
SS 界面 i 界面 
gamelost.png gamewin.png 
时 320*683 油 伐 此 县 轩 岛 0 
background.pn oN 
9 


开始 按钮 前 三 开始 开始 按钮 
button.png en button_press.png (RTF) 


怪物 蔡 痉 
enemy_fly.png (十 帧 ) 


BOSS 
308*49 泽 炸 收 本 S90 210*43 漂 炸 至 
FE png 研 顿 boos boom.png (五 帧 / 
17*29 
4 pi bulletpng 
本 20*20 
5 多 Boss 季冬 i Lenemy.png 
boosbullet png 


“PlaneGame ”项 目 使 用 的 图 片 资源 
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Boss 
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态 ; 


划分 游戏 状态 


为 了 让 整个 游戏 的 思路 与 代码 更 清晰 ， 游 戏 一 般 都 会 定义 一 些 常量 表示 当前 游戏 的 状 
比如 : 游戏 菜单 界面 、 游 戏 界面 、 游 戏 胜利 界面 、 游 戏 失败 界面 等 等 ， 整 个 游戏 划分 的 
状态 ， 对 应 到 代码 中 其 实 就 是 逻辑 函数 、 按 键 监听 事件 、 触 屏 监 听 事 件 以 及 绘制 函数 部 分 ; 
当然 游戏 的 图 片 加 载 也 可 以 根据 不 同 的 状态 进行 动态 加 载 ， 但 是 由 于 当前 项 目的 图 量 不 是 很 
多 ， 所 以 就 不 再 动态 加 载 。 

// 定 义 游戏 状态 常量 
public static 
public static 
public static 
public static 
Public static 
// 当 前 游戏 状态 (默认 初始 在 游戏 菜单 界面 ) 

Public static int gameState = GAME MENU; 


绘图 函数 : 


final 
final 
final 
final 
final 


int GAME_MENU = 0;// 游 戏 菜单 
int GAMEING = 1;// 游 戏 中 

int GAME WIN = 2;// 游 戏 胜利 
int GAME LOST = 3;// 游 戏 失败 
int GAME PAUSE = -1;// 游 戏 菜单 


Public void myDraw() { 


// 绘 图 函数 根据 游戏 状态 不 同 进行 不 同 绘制 

switch (gameState) { 

case GAME MENU: 
break; 

Case GAMEING: 
break; 

case GAME PAUSE: 
break; 


case GAME WIN: 


break; 
case GAME LOST: 
break; 


于 


实体 按键 按 下 监听 函数 : 


public boolean onKeyDown (int keyCode, KeyEvent event) { 
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// 按 键 监听 事件 函数 根据 游戏 状态 不 同 进行 不 同 监听 

Switch (9ameState) { 

case GAME MENU: 
break; 

Case GAMEING: 
break; 

Case GAME PAUSE: 
break; 

case GAME WIN: 
break; 

case GAME LOST: 
break; 


实体 按键 抬 起 监听 函数 : 


Public boolean onKeyUp (int keyCode, KeyEvent event) { 
// 按 键 监听 事件 函数 根据 游戏 状态 不 同 进行 不 同 监听 
Switch (gameState) { 
case GAME MENU: 

break; 
Case GAMEING: 
break; 
Case GAME PAUSE: 
break; 
case GAME WIN: 
break; 
Case GAME LOST: 
break; 


触 屏 事件 监听 函数 : 


Public boolean onTouchEvent (MotionEvent event) { 
// 触 屏 监听 事件 函数 根据 游戏 状态 不 同 进行 不 同 监听 
Switch (9ameState) { 
case GAME MENU: 

break; 
Case GAMEING: 
break; 
Case GAME PAUSE: 
break; 
case GAME WIN: 
break; 
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case GAME LOST: 
break; 

} 

return true; 


逻辑 函数 : 
private void logic() { 


// 罗 辑 处 理 根据 游戏 状态 不 同 进行 不 同 处 理 

switch (gameState) { 

case GAME MENU: 
break; 

Case GAMEING: 
break; 

Case GAME PAUSE: 
break; 

case GAME WIN: 
break; 

Case GAME LOST: 
break; 

} 


由 于 当前 游戏 素材 是 针对 游戏 竖 屏 状态 下 进行 的 ， 所 以 设置 当前 Activity 保持 竖 屏 ; 在 
AndroidManifest.xml 文件 中 : 


android:screenOrientation="portrait" 


游戏 初始 化 (菜单 界面 ) 


游戏 的 初始 化 ， 比 如 加 载 图 片 等 一 般 都 放 在 视图 创建 函数 中 进行 ， 是 因为 视图 宽 高 只 有 
在 视图 创建 中 才能 正常 获取 到 ， 一 些 图 片 坐标 等 都 要 根据 视图 宽 高 进行 设置 〈 考 虑 适 屏 ) 。 
除 此 之 外 ， 考 虑 到 游戏 胜利 或 者 失败 后 需要 重新 进入 游戏 等 因素 ， 应 该 添加 一 个 自 定 义 
函数 来 完成 游戏 初始 化 工作 ;一 旦 需要 重 置 游戏 ， 只 要 调用 此 函数 即 可 。 
// 声 明 一 个 Resources 实例 便于 加 载 图片 
Private Resources res = this.getResources () 


// 声 明 游戏 需要 用 到 的 图 片 资源 (图 片 声明 ) 
Private Bitmap bmpBackGround;// 游 戏 背景 
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Bitmap bmpBoom; // 爆 炸 效 果 

Bitmap bmpBoosBoom;//Boos 爆炸 效果 
Bitmap bmpButton;// 游 戏 开始 按钮 
Bitmap bmpButtonPress;// 游 戏 开始 按钮 被 点 击 
Bitmap bmpEnemyDuck; // 怪 物 鸭 子 
Bitmap bmpEnemyF1Y;// 怪 物 苍蝇 
Bitmap bmpEnemyBoos; // 怪 物 猪 头 Boos 
Bitmap bmpGameWin; // 游 戏 胜利 背景 
Bitmap bmpGameLost;// 游 戏 失败 背景 
Bitmap bmpPlayer;// 游 戏 主角 飞机 
Bitmap bmpPlayerHp;// 主 角 飞 机 血 量 
Bitmap bmpMenu; // 菜 单 背景 


public static Bitmap bmpBullet;// 子 弹 
public static Bitmap bmpEnemyBullet;// 敌 机 子弹 
public static Bitmap bmpBossBullet;//Boss 子弹 


视图 创建 函数 : 


Public void surfaceCreated (SurfaceHolder holder) { 


initGame () ; // 便 于 初始 化 游戏 


自 定义 initGame 函数 : 


Private 


void initGame () { 


// 放 置 游戏 切入 后 台 重 新 进入 游戏 时 ， 游 戏 被 重 置 ! 
// 当 游戏 状态 处 于 菜单 时 ， 才 会 重 置 游戏 
if (gameState == GAME MENU) { 


// 加 载 游戏 资源 
bmpBackGround = BitmapFactory.decodeResourcel(res, R.drawable 
.background); 
bmpBoom = BitmapFactory.decodeResource (res, R.drawable.boom); 
bmpBoosBoom = BitmapFactory.decodeResource (res, R.drawable 
.boos boom); 
bmpButton = BitmapFactory.decodeResource (res, R.drawable 
.button); 
bmpButtonPress = BitmapFactory.decodeResourcel(res, R.drawable 
.button press); 
bmpEnemyDuck = BitmapFactory.decodeResource(res, R.drawable 
-enemy duck); 
bmpEnemyFly = BitmapFactory.decodeResource (res, R.drawable 
.enemy fly); 
bmpEnemyBoos = BitmapFactory.decodeResource(res，R.drawable 
-enemy pig); 
bmpGameWin = BitmapFactory.decodeResource(res, R.drawable 
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.gamewin); 

bmpGameLost = BitmapFactory.decodeResourcel(res, R.drawable 
.gamelost); 

bmpPlayer = BitmapFactory.decodeResource (res, R.drawable 
.player); 


bmpPlayerHp = BitmapFactory.decodeResource (res, 

R.drawable. hp); 
bmpMenu = BitmapFactory.decodeResource (res, R.drawable.menu); 
bmpBullet = BitmapFactory.aecodeResource (res，R.drawable 


.bullet); 

bmpBullet = BitmapFactory.decodeResource (res, R.drawable 
.bullet); 

bmpBossBullet = BitmapFactory.decodeResource (res, R.drawable 
.boosbullet); 


当然 这 里 只 是 简单 的 初始 化 了 游戏 资源 图 而 已 ， 对 于 游戏 状态 初始 化 应 该 是 菜单 界面 ， 
下 面 来 新 建 一 个 菜单 类 ;每 个 界面 或 者 每 个 功能 单独 提出 来 做 一 个 类 ， 让 其 拥有 自己 的 逻 
辑 ， 绘 图 等 函数 ， 那 么 在 主 游戏 类 MySurfaceView 中 代码 和 思路 都 会 清晰 很 多 ; 但 并 不 是 所 
有 的 游戏 都 要 做 一 个 界面 ， 这 些 要 根据 具体 项 目 而 定 。 

新 建 类 GameMenu (菜单 界面 ) 的 代码 如 下 : 


Public class GameMenu { 

// 菜 单 背景 图 

Private Bitmap bmpMenu; 

// 按 钮 图 片 资源 ( 按 下 和 未 按 下 图 ) 

Private Bitmap bmpButton, bmpButtonPress; 

// 按 钮 的 坐标 

Private int btnX，btnY; 

// 按 钮 是 否 按 下 标识 位 

Private Boolean isPress; 

// 菜 单 初始 化 

Public GameMenu (Bitmap bmpMenu, Bitmap bmpButton, Bitmap 

bmpButtonPress) { 

this.bmpMenu = bmpMenu; 
this.bmpButton = bmpButton; 
this.bmpButtonPress = bmpButtonPress; 
//X 居中 ，Y 紧 接 屏幕 底部 
btnX = MySurfaceView.screenW / 2 - bmpButton.getNidth() / 2; 
btnY = MySurfaceView.screenH - bmpButton.getHeight (); 
isPress = false; 

} 

// 菜 单 绘图 函数 


Public void draw (Canvas canvas, Paint paint) { 
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// 绘 制 菜 单 背景 图 


canvas .drawBitmap (bmpMenu, 0, 0, paint); 
// 绘 制 未 按 下 按钮 图 
if (isPress) {// 根 据 是 否 按 下 绘制 不 同 状态 的 按钮 图 
canvas .drawBitmap (bmpButtonPress, btnXx, btnY, paint); 
} else { 
canvas .drawBitmap (bmpButton, btnxX, btnY, paint); 


} 
// 菜 单 触 屏 事 件 函 数 ， 主 要 用 于 处 理 按钮 事件 


Public void onTouchEvent (MotionEvent event) { 
// 获 取 用 户 当前 触 屏 位 置 
int PointX = (int) event.getX() 
int pointY = (int) event.getY() 
// 当 用 户 是 按 下 动作 或 移动 动作 
if (event .getRAction() 一 MotionEvent .ACTION DOWN || 
event .getRction () == MotionEvent.ACTION MOVE) { 
// 判 定 用 户 是 否 点 击 了 按钮 
if (pointX > btnX && PointX < btnX + 
bmpButton.getWwidth()) { 
if (PointY > btnY && pointY < btnY + 
bmpButton.getHeight () ) { 
isPress = true; 
} else { 
isPress = false; 
} 
} else { 
isPress = false; 


} 
// 当 用 户 是 抬 起 动作 
} else if (event.getAction() == MotionEvent.ACTION UP) { 
// 抬 起 判断 是 否 点 击 按钮 ， 防 止 用 户 移动 到 别处 
if (PointX > btnX && pointX < btnX + 


bmpButton .getwidth()) { 
if (PointY > btnY && pointY < btnY + 


bmpButton.getHeight ()) { 
// 还 原 Button 状态 为 未 按 下 状态 
isPress = false; 
// 改 变 当前 游戏 状态 为 开始 游戏 
MySurfaceView.gameState = 
MySurfaceView.GAMEING; 


1 
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从 菜单 类 中 可 以 看 到 它 拥 有 自己 的 绘图 、 触 屏 事 件 处 理 函 数 。 每 个 类 的 设计 封装 ， 不 是 
一 开始 就 能 想 的 很 全 面 ， 它 是 在 不 断 修改 项 目 ， 不 断 发 现 和 添加 中 完善 的 。 所 以 类 的 封装 ， 
一 开始 只 需要 将 能 想到 的 基本 属性 写 上 即 可 ， 比 如 此 菜单 类 ， 肯 定 能 想到 的 是 它 有 背景 ， 并 
且 有 按钮 、 那 么 按钮 则 需要 图 片 资源 、 坐 标 等 属性 。 其 他 的 可 能 想不到 ， 不 过 随 着 项 目 不 断 
完善 ， 需 要 用 到 时 就 会 自然 而 然 的 想到 ， 届 时 再 去 添加 完善 类 即 可 ， 千 万 不 要 一 开始 就 浪费 
大 量 时 间 去 设计 类 。 

菜单 类 完成 后 ， 主 视图 类 MySurfaceView 的 绘图 和 触 屏 事 件 交 给 菜单 自己 去 处 理 就 可 以 了 。 

MySurfaceView 类 修改 如 下 : 
// 声 明 一 个 菜单 对 象 


Private GameMenu gameMenu; 


初始 化 函数 : 


Private void initGame () { 
// 菜 单 类 实例 
gameMenu = new GameMenu (bmpMenu, bmpButton, bmpButtonPress); 


绘图 函数 : 


public void myDraw() { 


switch (gameState) { 
Case GAME MENU: 


// 菜 单 的 绘图 函数 
gameMenu.draw (canvas, paint); 
break; 

Case GAMEING: 
break; 

case GAME PAUSE: 
break; 

case GAME WIN: 
break; 

Case GAME LOST: 
break; 

外 
和 触 屏 监听 事件 ; 


Public boolean onTouchEvent (MotionEvent event) { 
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// 触 屏 监听 事件 函数 根据 游戏 状态 不 同 进行 不 同 监听 
Switch (9ameState) { 
case GAME MENU: 
// 菜 单 的 触 屏 事件 处 理 
gameMenu.onTouchEvent (event); 
break; 
Case GAMEING: 
break; 
Case GAME PAUSE: 
break; 
case GAME WIN: 
break; 
case GAME LOST: 
break; 
} 
return true; 


此 时 运行 项 目 ， 效 果 如 图 5-2 所 示 。 


含 的 元 素 : 滚动 的 游戏 背景 、 


消 戏 开始 


图 5-2 ”菜单 界面 〈 右 侧 图 按钮 为 点 击 后 的 效果 ) 


游戏 界面 


当 用 户 单 击 菜单 中 的 “游戏 开始 ”按钮 后 ， 即 可 进入 游戏 界面 。 首 先 分 析 整 个 游戏 中 包 
可 操作 的 主角 、 主 角 的 子弹 、 主 角 的 血 量 、 两 种 怪物 〈 敌 机 ) 
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和 一 个 Boss、 以 及 敌 机 和 Boss 的 爆炸 效果 。 


5.4.1 
如 果 想 让 游戏 背景 更 加 绚丽 ， 可 以 让 背景 有 多 层 ， 让 每 一 层 移动 速度 均 不 同 ， 还 有 一 些 


实现 滚动 的 背景 图 


游戏 背景 ， 比 如 RPG、ARPG 等 类 型 的 游戏 ， 都 是 由 小 图 片 拼 成 ， 实 现 方式 是 一 张 图 ， 有 多 
帧 图 块 ， 通 过 事先 定义 好 的 帧 下 标 数组 ， 按 照 其 数组 的 下 标 绘 制 对 应 图 块 帧 即 可 ; 本 项 目 中 
简单 的 实现 循环 播放 背景 图 。 


新 建 类 GameBg 的 代码 如 下 : 


public class GameBg { 
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// 游 戏 背 景 的 图 片 资源 

// 为 了 循环 播放 ， 这 里 定义 两 个 位 图 对 象 ， 

// 其 资源 引用 的 是 同一 张 图 片 

Private Bitmap bmpBackGroundl; 
private Bitmap bmpBackGround2; 

// 游 戏 背 景 坐标 

private int bglx, bgly, bg2x, bg2y; 
// 背 景 滚动 速度 


Private int speed = 3; 


// 游 戏 背景 构造 函数 
public GameBg (Bitmap bmpBackGround) { 
this .bmpBackGroundl = bmpBackGround; 
this .bmpBackGround2 = bmpBackGround; 
// 首 先 让 第 一 张 背 景 底部 正好 填 满 整个 屏幕 
bgly = -Math.abs(bmpBackGroundl .getHeight() - 
MySurfaceView. screenH); 
// 第 二 张 背 景 图 紧 接 在 第 一 张 背 景 的 上 方 
//+101 的 原因 : 虽然 两 张 背 景 图 无 缝隙 连 接 但 是 因为 图 片 资源 头 尾 
// 直 接连 接 不 和 谐 ， 为 了 让 视觉 看 不 出 是 两 张 图 连接 而 修正 的 位 置 
bg2y = bgly - bmpBackGroundl1 .getHeight () + 111; 


// 游 戏 背 景 的 绘图 函数 

public void draw(Canvas canvas, Paint paint) { 
// 绘 制 两 张 背 景 
canvas .drawBitmap (bmpBackGround1, bglx, bgly, paint); 
canvas .drawBitmap (bmpBackGround2, bg2x, bg2y, paint); 


} 
// 游 戏 背 景 的 逻辑 函数 
public void logic() { 
bgly += speed; 
bg2y += speed; 
// 当 第 一 张 图 片 的 Y 坐标 超出 屏幕 ， 
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// 立 即将 其 坐标 设置 到 第 二 张 图 的 上 方 
if (bgly > MySurfaceView.screenH) { 
bgly = bg2y - bmpBackGroundl .getHeight() + 111; 
’ 
// 当 第 二 张 图 片 的 Y 坐标 超出 屏幕 ， 
// 立 即将 其 坐标 设置 到 第 一 张 图 的 上 方 
if (bg2y > MySurfaceView.screenH) { 
bg2y = bgly - bmpBackGroundl .getHeight() + 111; 
} 


5.4.2 ”实现 主角 以 及 与 主角 相关 的 元 素 
本 小 节 实现 主角 以 及 与 主角 相关 的 元 素 。 新 建 类 Player 的 代码 如 下 : 


Public class Player { 

// 主 角 的 血 量 与 血 量 位 图 

// 默 认 3 血 

Private int PlayerHp = 3; 

private Bitmap bmpPlayerHp; 

// 主 角 的 坐标 以 及 位 图 

public int x, y; 

Private Bitmap bmpPlayer; 

// 主 角 移动 速度 

private int speed = 5; 

// 主 角 移动 标识 (基础 章节 已 讲解 ， 你 懂得 》 

Private boolean isUp, isDown, isLeft, isRight; 

// 主 角 的 构造 函数 

public Player (Bitmap bmpPlayer, Bitmap bmpPlayerHp) { 
this.bmpPlayer = bmpPlayer; 
this.bmpPlayerHp = bmpPlayerHp; 
x = MySurfaceView.screenW / 2 - bmpPlayer.getwidth() / 2; 
y = MySurfaceView. screenH - bmpPlayer.getHeight (); 


// 主 角 的 绘图 函数 

public void draw(Canvas canvas, Paint paint) { 
// 绘 制 主角 
canvas .drawBitmap (bmpPlayer, x, y, paint); 
// 绘 制 主角 血 量 


for (int i = 0; i < playerHp; i++) { 
canvas .drawBitmap (bmpPlayerHp, i * bmpPlayerHp.getWwidth(), 
MySurfaceView.screenH - bmpPlayerHp.getHeight(), paint); 
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背景 和 主角 类 完成 已 初步 完成 ， 需 要 添加 到 主 视图 MySurfaceView 类 中 。 
首先 声明 两 个 类 的 成 员 对 象 : 


初始 化 游戏 函数 : 
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实体 按键 按 下 监听 函数 : 


实体 按键 抬 起 监听 函数 : 
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逻辑 函数 : 


运行 当前 项 目 ， 效 果 如 图 5-3 所 示 。 
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5-3 ”游戏 背景 与 主角 


5.4.3 ”怪物 〈 敌 机 ) 类 的 实现 


怪物 类 不 同 于 主角 ， 它 的 移动 是 不 受 玩 家 控制 的 ， 拥 有 自己 的 AI (逻辑 ) ， 而 且 它 的 朝 
向 是 朝 下 ， 主 角 的 运动 则 是 朝 上 ， 并 且 主 角 只 有 一 个 ， 而 怪物 则 有 多 个 ; 所 以 怪物 类 的 封装 
至 少 会 拥有 一 个 类 型 属性 ， 用 以 判定 当前 怪物 的 种 类 ， 毕 竞 每 个 怪物 可 能 血 量 不 同 ，AI 不 同 
等 等 ， 所 以 添加 一 个 类 型 属性 来 便于 区 分 。 

新 建 类 Enemy 的 代码 如 下 : 


public class Enemy { 
// 敌 机 的 种 类 标识 
Public int type; 
// 苍 蝇 
public static final int TYPE FLY= 1; 
// 鸭 子 ( 从 左 往 右 运动 ) 
public static final int TYPE DUCKL = 2; 
// 有 鸭子 (从 右 往 左 运动 ) 
public static final int TYPE DUCKR = 3; 
// 政 机 图 片 资 源 
public Bitmap bmpEnemy; 
// 敌 机 坐标 
public int x, y; 
// 敌 机 每 帧 的 宽 高 
private int frameW, frameH; 
// 敌 机 当前 帧 下 标 
Private int frameIndex; 
// 敌 机 的 移动 速度 


private int speed;; 
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// 判 断 敌 机 是 否 已 经 出 屏 
public boolean isDead; 
// 敌 机 的 构造 函数 
public Enemy (Bitmap bmpEnemy, int enemyType, int x, int y) { 
this .bmpEnemy = bmpEnemy; 
frameW = bmpEnemy.getWidth() / 10; 
frameH = bmpEnemy.getHeight (); 
this.type = enemyType; 
this,x = x? 


this.y = y; 
// 不 同 种 类 的 敌 机 速度 不 同 
switch (type) { 
// 苍 蝇 
Case TYPE FLY: 
speed = 25; 
break; 
// 鸭 子 
case TYPE DUCKL: 
speed = 3; 
break; 
Case TYPE DUCKR: 
speed = 3; 
break; 
} 
有 
// 政 机 绘图 函数 


public void draw(Canvas canvas, Paint paint) { 
canvas .save (); 
canvas.clipRect (x, y, x + frameW, y + frameH); 
canvas.drawBitmap (bmpEnemy, x - frameIndex * frameW,y, paint); 
canvas.restore(); 
上. 
// 敌 机 逻辑 AI 
public void logic() { 
// 不 断 循环 播放 帧 形成 动画 
frameIndex++; 
if (frameIndex >= 10) { 
frameIndex = 0; 
} 
/ /不同 种 类 的 敌 机 拥有 不 同 的 AI 逻辑 
switch (type) { 
case TYPE FLY: 
if (isDead 一 false) { 
// 减 速 出 现 ， 加 速 返回 
speed -= 1; 
y += speed; 
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不 论 是 敌 机 还 是 主角 都 拥有 一 个 设置 血 量 的 函数 ， 这 也 是 为 了 后 续 添加 敌 机 与 主角 、 敌 
机 子弹 与 主角 之 问 碰 撞 处 理 留 下 的 接口 ;当然 现在 也 可 以 不 写 ， 毕 竟 当 前 还 没有 用 到 此 函数 
的 地 方 。 

敌 机 类 设计 完毕 之 后 ， 将 其 逻辑 和 绘制 都 添加 到 主 视图 MySurfaceView 中 : 


这 里 定义 的 二 维 数 组 ， 其 中 每 一 维 是 每 次 创建 敌 机 时 的 敌 机 种 类 和 数量 ， 这 样 定义 主要 
是 便于 管理 游戏 敌 机 数量 和 难度 以 及 游戏 时 间 等 。 

一 般 在 游戏 开发 中 会 将 其 数组 写成 流 文件 进行 保存 ， 以 流 文件 的 方式 保存 一 方面 仍 是 为 
了 便于 管理 ， 另 一 方面 对 于 关卡 设计 简单 的 做 了 一 个 加 密 。 

游戏 初始 化 函数 : 


绘图 函数 : 


逻辑 函数 : 
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// 敌 机 逻辑 
for (int i = 0; i < vcEnemy.size(); i++) { 
Enemy en = vcEnemy.elementAt (i); 
/ /因为 容器 不 断 添加 敌 机 ， 那么 对 敌 机 isDead 判定 ， 
// 如 果 已 死亡 那么 就 从 容器 中 删除 , 对 容器 起 到 了 优化 作用 ; 
if (en.isDead) { 
vcEnemy .removeElementAt (i); 
} else { 
en.logic(); 


} 
// 生 成 敌 机 
count++; 
if (count % createEnemyTime == 0) { 
for (int i = 0; i < enemyArray[enemyArrayIndex]. length; i++) { 
// 苍 蝇 
if (enemyRrray[enemyRrrayIndex] [i] == 1) { 
int x = random.nextInt (screenW - 100) + 50; 
vcEnemy .addElement (new Enemy (bmpEnemyFly, 1, x, - 
50)); 
// 鸭 子 左 
} else if (enemyArray[enemyArrayIndex] [i] == 2) { 
int y = random.nextInt (20); 
vcEnemy .addElement (new Enemy (bmpEnemyDuck, 2, - 
50, y)); 
// 鸡 子 右 
} else if (enemyArray[enemyArrayIndex] [i] == 3) { 
int y = random.nextInt (20); 
vcEnemy .addElement (new Enemy (bmpEnemyDuck, 3, 
screenW + 50, y)); 
} 


// 这 里 判断 下 一 组 是 否 为 最 后 一 组 (Boss) 
if (enemyArrayIndex == enemyArray.length - 1) { 
isBoss = true; 


}elsef{ 
enemyArrayIndex++; 
jy 
} 
} else { 
//Boss 逻辑 


， 


在 绘图 和 人 逻辑 函数 中 都 对 以 后 的 Boss 类 留 下 了 接口 。 
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运行 项 目 ， 效 果 如 图 5-4 所 示 。 

到 此 敌 机 与 主角 都 存在 了 ， 那 么 接 下 来 就 要 开始 实现 它们 之 间 碰 撞 的 关系 。 一 般 飞 行 射 
击 类 型 的 游戏 中 ， 主 角 与 敌 机 接触 后 ， 主 角 会 被 扣除 血 量 ， 而 敌 机 不 会 ; 敌 机 只 有 在 被 主角 
的 子弹 击 中 才 会 扣除 血 量 ， 当 然 在 后 续 完善 项 目 中 会 实现 此 功能 ， 当 前 应 该 实现 的 是 敌 机 与 
主角 之 间 的 碰撞 关系 。 

修改 主角 Player 类， 为 其 添加 一 个 检测 主角 与 敌 机 碰撞 的 函数 : 
// 判 断 碰 撞 (主角 与 敌 机 ) 


public boolean isCollsionWith (Enemy en) { 
int x2 = en.x; 


int y2 = en.y; 
int w2 = en.frameW; 
int h2 = en.frameH; 


if (x >= x2 && x >= x2 + w2) { 
return false; 

} else if (x <= x2 && x + bmpPlayer.getWwidth() <= x2) { 
return false; 

} else if (y >= y2 && y >= y2 + h2) { 
return false; 

} else if (y <= y2 && y + bmpPlayer.getHeight() <= y2) { 
return false; 

让 

return true; 


图 5-4 三 种 运动 轨迹 类 型 的 敌 机 


然后 修改 主 视图 MySurfaceView， 在 游戏 中 添加 处 理 碰撞 逻辑 : 
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/ /处理 敌 机 与 主角 的 碰撞 
for (int i = 0; i < vcEnemy.size(); i++) { 
if (player.isCollsionWith (vcEnemy.elementAt (i))) { 
// 发 生 碰撞 ， 主 角 血 量 -1 
player .setPlayerHp (player.getPlayerHp() - 1); 


这 里 还 需要 再 处 理 一 下 ， 当 主角 与 敌 机 或 者 以 后 主角 与 敌 机 的 子弹 ) 发 生 碰撞 时 ， 主 
角 极 大 的 可 能 还 处 在 与 敌 机 碰撞 的 位 置 ， 因 为 游戏 循环 逻辑 不 断 循环 处 理 ， 玩 家 可 能 还 没 来 
及 移动 主角 ， 所 以 增加 一 个 状态 ， 当 主角 发 生 碰撞 时 ， 设 置 数 秒 无 敌 时 间 无敌 时 间 根 据 需 


求 设置 ) 。 

修改 Player 类 ， 添 加 必须 的 成 员 变 量 : 
// 碰 撞 后 处 于 无 敌 时 间 
// 计 时 器 
Private int noCollisionCount = 0; 
// 因 为 无 敌 时 间 
Private int noCollisionTime = 60; 
// 是 否 碰撞 的 标识 位 


Private boolean isCollision; 


修改 主角 与 敌 机 的 碰撞 函数 : 


// 判 断 碰撞 (主角 与 敌 机 ) 
public boolean isCollsionWith (Enemy en) { 
// 是 否 处 于 无 敌 时 间 
if (isCollision == false) { 
int x2 = en.x; 


int y2 = en.y; 
int w2 = en.frameW; 
int h2 = en.frameH; 


if (x >= x2 && x >= x2 + w2) { 
return false; 

} else if (x <= x2 && x + bmpPlayer.getwidth() <= x2) { 
return false; 

} else if (y >= y2 && y >= y2 + h2) { 
return false; 

} else if (y <= y2 && y + bmpPlayer.getHeight() <= y2) { 
return false; 


} 
// 碰 撞 即 进入 无 敌 状态 
isCollision = true; 
return true; 

// 处 于 无 敌 状态 ， 无 视 碰撞 


} else { 
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return false; 


修改 逻辑 函数 : 


/ /主角 的 逻辑 
Public void logic() { 


// 处 理 无 敌 状态 
if (isCollision) { 
// 计 时 器 开始 计时 
noCollisionCount++; 
if (noCollisionCount >= noCollisionTime) { 
/ /无敌 时 间 过 后 ， 接 触 无 敌 状态 及 初始 化 计数 器 
isCollision = false; 
noCollisionCount = 0; 


当主 角 进 入 无 敌 状态 时 ， 计 时 器 的 递增 没有 写 入 碰撞 函数 ， 而 是 写 在 了 主角 的 逻辑 函数 
中 ! 原 因 在 于 ， 当 整个 游戏 逻辑 执行 一 次 时 ， 主 角 的 逻辑 也 只 执行 一 次 ;但 是 主角 的 碰撞 函数 
并 不 只 是 执行 一 次 。 如 果 怪 物 数 量 有 多 个 ， 这 个 函数 将 会 被 调用 多 次 ， 那 么 如 果 将 无 敌 状态 
的 计时 器 放 在 主角 与 敌 机 的 碰撞 函数 中 ， 计 时 器 每 次 递增 就 不 是 1 了 ， 而 递增 的 值 将 与 当前 
存在 的 敌 机 数量 相同 。 

虽然 此 时 对 主角 进入 无 敌 的 状态 处 理 完 毕 ， 但 是 对 于 玩家 来 说 ， 在 视觉 上 没有 任何 的 变 
化 ， 那 么 为 了 体现 主角 已 进入 无 敌 状态 ， 这 里 对 主角 的 绘制 进行 处 理 ， 让 主角 在 无 敌 状态 下 

修改 主角 的 绘制 : 
// 主 角 的 绘图 函数 


public void draw(Canvas canvas, Paint paint) { 

/ /绘制 主角 
// 当 处 于 无 敌 时 间 时 ， 让 主角 闪烁 
if (isCollision) { 

// 每 2 次 游戏 循环 ， 绘 制 一 次 主角 

if (noCollisionCount % 2 == 0) { 

canvas .drawBitmap (bmpPlayer, x, y, paint); 

} else { 

canvas .drawBitmap (bmpPlayer, x, y, paint); 
: 
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运行 项 目 ， 效 果 如 图 5-5 所 示 。 
图 5-5 的 最 右 侧 图 中 找 不 到 主角 的 原因 是 因为 主角 与 敌 机 发 生 碰撞 后 处 于 无 敌 ， 闪 烁 的 
状态 ， 若 隐 若 现 。 接 下 来 为 主角 与 敌 机 加 上 子弹 。 


图 5-5 主角 与 敌 机 碰撞 


首先 新 建 子 弹 类 Bullet: 


public class Bullet { 
// 子 弹 图 片 资源 
public Bitmap bmpBullet; 
// 子 弹 的 坐标 
Public int bulletx, bulletYy; 
// 子 弹 的 速度 
public int speed; 
// 子 弹 的 种 类 以 及 常量 
public int bulletType; 
// 主 角 的 
public static final int BULLET PLAYER = -1; 
// 鸭 子 的 
public static final int BULLET DUCK = 1; 
// 苍 蝇 的 
public static final int BULLET FLY = 2; 
//Boss 的 
Public static final int BULLET BOSS = 3; 
// 子 弹 是 否 超 屏 ， 优化 处 理 


public boolean isDead; 


// 子 弹 构造 函数 
public Bullet (Bitmap bmpBullet, int bulletx, int bulletY，int 
bulletType) { 
this.bmpBullet = bmpBullet; 


244 


子弹 类 设计 完成 之 后 (Boss 子弹 此 时 没有 添加 逻辑 处 理 ) ， 在 主 游戏 视图 MySurfaceView 
中 为 敌 机 与 主角 添加 子弹 : 
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countEnemyBullet++; 


if (countEnemyBullet $ 40 =— 0) { 
for (int i = 0; i < vcEnemy.size(); i++) { 

Enemy en = vcEnemy.elementAat (i); 

// 不 同类 型 敌 机 不 同 的 子弹 运行 轨迹 

int bulletType = 0; 

switch (en.type) { 

// 苍 蝇 

Case Enemy.TYPE FLY: 
bulletType=Bullet .BULLET FLY; 
break; 

// 有 鸭子 

Case Enemy.TYPE DUCKL: 

Case Enemy.TYPE DUCKR: 
bulletType=Bullet .BULLET DUCK; 
break; 

} 

vcBullet .add (new Bullet (bmpEnemyBullet, 

en.x + 10, en.y + 20, bulletType)); 
} 
. 
/ /处理 敌 机 子弹 逻辑 
for (int i = 0; i < vcBullet.size(); i++) { 
Bullet b = vcBullet .elementAt (i); 
if (b.isDead) { 
vcBullet.removeElement (b); 
} else { 
blogic(js 


,1 
} else { 
//Boss 逻辑 
} 
// 每 1 秒 添 加 一 个 主角 子弹 
countPlayerBullet++; 
if (countPlayerBullet $ 20 =—= 0) { 
vcBulletPlayer.add (new Bullet (bmpBullet, player.x + 15, 
player.y - 20, Bullet.BULLET PLAYER)); 
} 
// 处 理 主角 子弹 逻辑 
for (int i = 0; i < vcBulletPlayer.size(); i++) { 
Bullet b = vcBulletPlayer.elementAt (i); 
if (b.isDead) { 
vcBulletPlayer.removeElement (b) ; 
} else { 
Db-logic()s 
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敌 机 与 敌 机 子弹 的 绘制 与 逻辑 都 写 在 了 Boss 没有 出 现 的 状态 中 ， 因 为 当 Boss 出 现时 ， 
敌 机 与 敌 机 子弹 都 将 消失 ， 而 主角 与 主角 子弹 在 Boss 出 现时 也 会 存在 ， 所 以 主角 以 及 主角 子 
弹 不 受 Boss 影响 . 


运行 项 目 ， 效 果 如 图 5-6 所 示 。 


5-6 主角 与 敌 机 的 子弹 


子弹 的 绘制 与 逻辑 除 Boss 外 都 已 完成 ， 紧 跟着 就 应 该 添加 敌 机 与 主角 子弹 之 间 的 碰撞 逻 
辑 。 

分 析 一 下 : 当主 角 的 子弹 与 敌 机 碰撞 后 ， 敌 机 死亡 消失 ， 并 且 产 生 爆 炸 效果 ;而 敌 机 的 
子弹 与 主角 碰撞 后 ， 主 角 的 血 量 减 1， 和 暂且 不 实现 爆炸 效果 。 

首先 修改 Player 类 ， 为 主角 添加 与 敌 机 子弹 碰撞 的 逻辑 函数 : 


/ /判断 碰撞 (主角 与 敌 机 子弹 ) 
public boolean isCollsionWith(Bullet bullet) { 
// 是 否 处 于 无 敌 时 间 
if (isCollision == false) { 
int x2 = bullet.bulletx; 
int y2 = bullet.bulletYy; 
int w2 = bullet.bmpBullet.getWidth(); 
int h2 = bullet.bmpBullet.getHeight (); 
EC 
return false; 
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} else if (x <= x2 && x + bmpPlayer.getWidth() <= x2) { 
return false; 

} else if (y >= y2 && y >= y2 + h2) { 
return false; 

} else if (y <= y2 && y + bmpPlayer.getHeight() <= y2) { 
return false; 


} 
// 碰 撞 即 进入 无 敌 状态 
isCollision = true; 
return true; 
// 处 于 无 敌 状态 ， 无 视 碰撞 
} else { 
return false; 
} 


此 方法 与 主角 跟 敌 机 碰撞 函数 几乎 一 样 ， 不 再 资 述 ， 在 主 视图 MySurfaceView 的 逻辑 函 
数 中 添加 以 下 代码 : 


// 处 理 敌 机 子弹 与 主角 碰撞 
for (int i = 0; i < vcBullet.size(); i++) { 
if (player.isCollsionWith (vcBullet.elementAt(i))) { 
// 发 生 碰 撞 ， 主 角 血 量 -1 
player.setPlayerHp (player.getPlayerHp() - 1); 
// 当 主角 血 量 小 于 0， 判定 游戏 失败 
if (Player.getPlayerHp () <= -1) { 
9ameState = GAME LOST; 

} 


然后 添加 主角 子弹 与 敌 机 的 碰撞 ， 修 改 Enemy 类 ， 添 加 碰撞 函数 : 


/ /判断 碰撞 ( 敌 机 与 主角 子弹 碰撞 ) 
Public boolean isCollsionWith(Bullet bullet) { 
int x2 = bullet.bulletx; 
int y2 = bullet.bulletYy; 
int w2 = bullet.bmpBullet .getWwidth (); 
int h2 = bullet.bmpBullet .getHeight (); 
if (x >= x2 && x >= x2 + w2) { 
return false; 
} else if (x <= x2 && x + frameW <= x2) { 
return false; 
} else if (y >= y2 && y >= y2 + h2) { 
return false; 
} else if (y <= y2 && y + frameH <= y2) { 
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return false; 


} 

// 发 生 碰 撞 ， 让 其 死亡 
isDead = true; 
return true; 


在 主 视图 MySurfaceView 中 添加 逻辑 : 
// 处 理 主角 子弹 与 敌 机 碰撞 


for (int i = 0; i < vcBulletPlayer.size(); i++) { 

// 取 出 主角 子弹 容器 的 每 个 元 素 

Bullet blPlayer = vcBulletPlayer.elementAt (i); 

for (int j = 0; j < vcEnemy.size(); j++) { 
// 取 出 敌 机 容器 的 每 个 元 与 主角 子弹 遍历 判断 
if (vcEnemy.elementAt (j).isCollsionWith (blPlayer)){ 

/ /添加 爆炸 效果 

} 


这 里 留 下 了 爆炸 的 接口 ， 当 主角 子弹 与 敌 机 发 生 碰 撞 后 ， 将 在 爆炸 效果 的 容器 中 添加 一 
个 爆炸 类 对 象 实例 。 下 面 就 来 实现 爆炸 类 ， 以 及 爆炸 的 绘制 与 逻辑 。 
新 建 类 Boom: 


public class Boom { 

// 爆 炸 效果 资源 图 

private Bitmap bmpBoom; 

// 爆 炸 效果 的 位 置 坐标 

private int boomX, boomY; 

// 爆 炸 动画 播放 当前 的 帧 下 标 

private int cureentFrameIndex; 

// 爆 炸 效果 的 总 帧 数 

Private int totleFrame; 

// 每 帧 的 宽 高 

private int frameW, frameH; 

// 是 否 播放 完毕 ， 优 化 处 理 

public boolean playEnd; 

// 爆 炸 效果 的 构造 函数 

public Boom(Bitmap bmpBoom, int x, int y, int totleFrame) { 
this .bmpBoom = bmpBoom; 
this .boomX = x; 
this.boomY = y; 
this.totleFrame = totleFrame; 
frameW = bmpBoom.getWidth() / totleFrame; 
frameH = bmpBoom.getHeight (); 
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} 
// 爆 炸 效果 绘制 
Public void draw (Canvas canvas, Paint paint) { 
canvas .save () 7 
canvas .ClipRect (boomX, boomY, boomX + frameW, boomY + frameH); 


canvas .drawBitmap (bmpBoom, boomX - cureentFrameIndex * frameW, 
boomY, paint); 


canvas.restore(); 


} 
// 爆 炸 效果 的 逻辑 
public void logic() { 
if (cureentFrameIndex < totleFrame) { 
cureentFrameIndext++; 
} else { 
playEnd = true; 
} 


爆炸 效果 分 两 种 类 型 ， 一 种 是 普通 敌 机 的 ， 一 种 是 Boss 的 爆炸 效果 ， 当 前 留 下 Boss 爆 
炸 效 果 的 逻辑 处 理 接口 ， 暂 且 不 实现 。 


在 主 视图 MySurfaceView 中 添加 爆炸 效果 ， 代 码 如 下 : 
// 爆 炸 效果 容器 


Private Vector<Boom> vcBoom = new Vector<Boom> (); 
绘图 函数 : 
// 爆 炸 效果 绘制 


for (int i = 0; i < vcBoom.size(); i++) { 
vcBoom.elementAt (i) .draw (canvas, paint); 


} 
逻辑 函数 : 
// 处 理 主角 子弹 与 敌 机 碰撞 


for (int i = 0; i < vcBulletPlayer.size(); i++) { 

// 取 出 主角 子弹 容器 的 每 个 元 素 

Bullet blPlayer = vcBulletPlayer.elementAt (i); 

for (int j = 0; j < vcEnemy.size(); j++) { 
// 添 加 爆炸 效果 
// 取 出 敌 机 容器 的 每 个 元 与 主角 子弹 遍历 判断 
if (vcEnemy.elementAt(j) .isCollsionWith(blPlayer)) { 

vcBoom.add (new Boom (bmpBoom, vcEnemy.elementAt (j) .x, 
vcEnemy.elementAt (j) .y, 7)); 
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} 
/ /爆炸 效果 多 辑 
for (int i = 0; i < vcBoom.size(); i++) { 
Boom boom = vcBoom.elementAt (i); 
if (boom.playEnd) { 
// 播 放 完毕 的 从 容器 中 删除 
VCcBoom.removeElementRt (i); 
} else { 
vcBoom.elementAt (i) .logic(); 
} 


运行 项 目 ， 效 果 如 图 5-7 所 示 。 


图 5-7 爆炸 效果 


最 后 就 是 设计 最 终 Boss。 既 然 是 Boss， 那 么 就 不 能 被 主角 一 颗 子弹 打 死 ， 所 以 血 量 肯定 
要 多 ， 并 且 子 弹 罗 和 辑 除了 垂直 运动 外 ， 还 为 Boss 添加 一 个 疯狂 的 状态 。 在 疯狂 状态 下 ，Boss 
会 同时 发 射 八 方向 子弹 ， 使 整个 游戏 困难 度 提 高 。 

也 就 是 说 Boss 拥有 两 套子 弹 运 动 轨迹 ， 创 建 Boss 垂直 下 落 的 子弹 时 直接 使 用 之 前 敌 机 
的 子弹 轨迹 即 可 。 然 后 再 为 Bullet 子弹 类 添加 Boss 同时 发 射 八方 向 子弹 时 运动 轨迹 和 逻辑 。 

Bullet 类 修改 如 下 : 


//Boss 疯狂 状态 下 子弹 相关 成 员 变量 

Private int dir;// 当 前 Boss 子弹 方向 

/18 方向 常量 

Public static final int DIR UP = -1; 
Public static final int DIR DOWN = 2; 
Public static final int DIR LEFT = 3; 
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public static final int DIR RIGHT = 4; 
public static final int DIR UP LEFT = 5; 
Public static final int DIR UP RIGHT = 6; 
public static final int DIR DOWN LEFT = 7; 
Public static final int DIR DOWN RIGHT = 8; 


青 添加 一 个 子弹 类 的 构造 函数 : 


/*w 
专用 于 处 理 Boss 疯狂 状态 下 创建 的 子弹 
@param bmpBullet 
@param bulletXx 
@param bulletY 
@param bulletType 
* @param Dir 
2 
public Bullet (Bitmap bmpBullet, int bulletX，int bulletY，int 
bulletType, int dir) { 
this.bmpBullet = bmpBullet; 
this.bulletX = bulletx; 
this.bulletY = bulletYy; 
this.bulletType = bulletType; 
speed = 5; 
this.dir = dir; 


并 半 并 并 4 


子弹 逻辑 中 Boss 类 型 子弹 的 处 理 : 


/ /子弹 的 逻辑 
public void logic() { 


//Boss 疯狂 状态 下 的 8 方向 子弹 逻辑 
Case BULLET BOSS: 
//Boss 疯狂 状态 下 的 子弹 逻辑 待 实 现 
switch (dir) { 
// 方 向 上 的 子弹 
case DIR UP: 
bulletY -= speed; 
break; 
// 方 向 下 的 子弹 
case DIR DOWN: 
bulletY += speed; 
break; 
// 方 向 左 的 子弹 
Case DIR LEFT: 
bulletX -= speed; 
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封装 Boss 类 ， 新 建 类 “Boss”: 
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private int frameIndex; 

//Boss 运动 的 速度 

private int speed = 5; 

//Boss 的 运动 轨迹 

// 一 定时 间 会 向 着 屏幕 下 方 运 动 ， 并 且 发 射 大 范围 子弹 ， 是 否 狂 态 ) 
// 正 常 状态 下 ， 子 弹 垂 直 朝 下 运动 

Private boolean isCrazy; 

// 进 入 疯狂 状态 的 状态 时 间 间 隔 

Private int crazyTime = 200; 

// 计 数 器 


Private int count; 


//Boss 的 构造 函数 

public Boss (Bitmap bmpBoss) { 
this.bmpBoss = bmpBoss; 
frameW = bmpBoss.getWidth() / 10; 
frameH = bmpBoss.getHeight (); 
//Boss 的 X 坐标 居中 
x = MySurfaceView.screenW / 2 - frameW / 2; 
Y= 07 

jf 

//Boss 的 绘制 

Public void draw (Canvas canvas, Paint paint) { 
canvas.save (); 
canvas.clipRect (x, y, x + frameW, y + frameH); 
canvas .drawBitmap (bmpBoss, x - frameIndex * frameW, y, paint); 
canvas.restore(); 


//Boss 的 逻辑 
public void logic() { 
// 不 断 循环 播放 帧 形成 动画 
frameIndext++; 
if (frameIndex >= 10) { 
frameIndex = 0; 
} 
// 没 有 疯狂 的 状态 
if (isCrazy == false) { 
x += speed; 
if (x + frameW >= MYSurfaceView.screenm) { 
speed = -speed; 
} else if (x <= 0) { 
speed = -speed; 
上 
count++; 
if (count $ crazyTime == 0) { 
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isCrazy = true; 
speed = 24; 
} 
// 疯 狂 的 状态 
} else { 
speed -= 1; 
// 当 Boss 返回 时 创建 大 量子 弹 
if (speed 一 0) { 
// 添 加 8 方向 子弹 
MySurfaceView.vcBulletBoss.add (new 
Bullet (MySurfaceView.bmpBossBullet, x+30, y, Bullet.BULLET BOSS, 
Bullet .DIR UP)); 
MySurfaceView.vcBulletBoss.add (new 
Bullet (MySurfaceView.bmpBossBullet, x+30, y, Bullet.BULLET BOSS, 
Bullet .DIR DOWN)); 
MySurfaceView.vcBulletBoss.add (new 
Bullet (MySurfaceView.bmpBossBullet, x+30, y, Bullet.BULLET BOSS, 
Bullet .DIR LEFT)); 
MySurfaceView.vcBulletBoss.add (new 
Bullet (MySurfaceView.bmpBossBullet, x+30, y, Bullet.BULLET BOSS, 
Bullet .DIR RIGHT)); 
MySurfaceView.vcBulletBoss.add (new 
Bullet (MySurfaceView.bmpBossBullet, x+30, y, Bullet.BULLET BOSS, 
Bullet .DIR UP LEFT)); 
MySurfaceView.vcBulletBoss.add (new 
Bullet (MySurfaceView.bmpBossBullet, x+30, y, Bullet.BULLET BOSS, 
Bullet .DIR UP RIGHT)); 
MySurfaceView.vcBulletBoss.add (new 
Bullet (MySurfaceView.bmpBossBullet, x+30, y, Bullet.BULLET BOSS, 
Bullet .DIR DOWN LEFT)); 
MySurfaceView.vcBulletBoss.add (new 
Bullet (MySurfaceView.bmpBossBullet, x+30, y, Bullet.BULLET BOSS, 
Bullet .DIR DOWN RIGHT)); 
y += speed; 
a Ke 
/ /恢复 正常 状态 
isCrazy = false; 
speed = 5; 


; 
// 判 断 碰撞 (Boss 被 主角 子弹 击 中 ) 


public boolean isCollsionWith (Bullet bullet) { 
int x2 = bullet.bulletx; 
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//Boos 的 绘制 

boss.draw (canvas, paint); 

//Boss 子弹 逻辑 

for (int i = 0; i < vcBulletBoss.size(); i++) { 
vcBulletBoss.elementAt (i) .draw (canvas, paint); 


逻辑 函数 : 
private void logic() { 


//Boss 相关 逻辑 
// 每 0.5 秒 添加 一 个 主角 子弹 
boss.logic(); 
if (countPlayerBullet % 10 == 0) { 
//Boss 的 没 发 疯 之 前 的 普通 子弹 
vcBulletBoss.add (new Bullet (bmpBossBullet, boss.x + 35, 
boss.y + 40, Bullet.BULLET FLY)); 


} 
//Boss 子弹 逻辑 
for (int i = 0; i < vcBulletBoss.size(); i++) { 
Bullet b = vcBulletBoss.elementAt (i); 
if (b.isDead) { 
vcBulletBoss.removeElement (b); 
} else { 
b.logic(); 
} 
b 
//Boss 子弹 与 主角 的 碰撞 
for (int i = 0; i < vcBulletBoss.size(); i++) { 
if (player.isCollsionWith(vcBulletBoss.elementAt(i))) { 
// 发 生 碰 撞 ， 主 角 血 量 -1 
player.setPlayerHp (player.getPlayerHp() - 1); 
// 当 主角 血 量 小 于 0， 判 定 游戏 失败 
if (player.getPlayerHp() <= -1) { 
gameState = GAME LOST; 
} 
} 
//Boss 被 主角 子弹 击 中 ， 产 生 爆 炸 效果 
for (int i = 0; i < vcBulletPlayer.size(); i++) { 
Bullet b = vcBulletPlayer.elementAt (i); 
if (boss.isCollsionWith(b)) { 
if (boss.hp <= 0) { 
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/ /游戏 胜利 
9ameState = GAME WIN; 
} else { 

// 及 时 删除 本 次 碰撞 的 子弹 ， 防 止 重复 判定 此 子弹 与 Boss 碰撞 

b.isDead = true; 

//Boss 血 量 减 1 

boss.setHp (boss.hp - 1); 

// 在 Boss 上 添加 三 个 Boss 爆炸 效果 

vcBoom.add (new Boom (bmpBoosBoom, boss.x + 25, 
bosssy + 307 SH}? 

vcBoom.add (new Boom (bmpBoosBoom, boss.x + 35, 
boss.y + 40, 5)); 

vcBoom.add (new Boom (bmpBoosBoom, boss.x + 45, 
bossvy + 50 5))s 


运行 项 目 ， 效 果 如 图 5-8 所 示 。 


图 5-8 Boss 与 Boss 子弹 
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游戏 胜利 与 结束 界面 


对 于 游戏 胜利 与 失败 的 条 件 ， 在 5.4 小 节 中 都 已 经 有 了 判定 ， 这 里 只 需要 做 的 是 在 游戏 
胜利 或 失败 的 状态 下 绘制 相对 应 的 背景 图 即 可 。 
在 主 视图 MySurfaceView 的 绘图 函数 中 ， 添 加 胜利 和 失败 游戏 状态 的 绘制 代码 : 
/** 
* 游戏 绘图 
i 
public void myDraw() { 


case GAME WIN: 


canvas .drawBitmap (bmpGameWin, 0, 0, paint); 
break; 
Case GAME LOST: 


canvas .drawBitmap (bmpGameLost, 0, 0, paint); 


胜利 和 失败 的 界面 如 图 5-9 所 示 。 


GAME OVER 


图 5-9 胜利 和 失败 的 界面 
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游戏 细节 处 理 


5.6.1 ”游戏 Back 返回 键 处 理 


介绍 SurfaceView 机 制 时 ， 讲 述 过 当 用 户 单 击 Back 返回 按键 时 ， 当 前 运行 的 应 用 会 被 切 
入 后 台 ， 并 且 重 新 进入 应 用 时 ， 会 重启 活动 。 而 且 当 设备 内 存 吃紧 时 ， 切 入 后 台 的 程序 随时 
都 有 可 能 被 切断 ， 所 以 在 游戏 开发 中 ， 一 般 都 会 屏蔽 或 者 处 理 掉 此 按钮 。 

针对 当前 飞行 射击 的 游戏 来 说 ， 当 游戏 处 于 进行 状态 ， 或 者 游戏 胜利 与 失败 状态 时 ， 单 
击 返回 按键 返回 菜单 即 可 ， 其 他 游戏 状态 下 不 进行 任何 的 处 理 ， 放 置 程序 切入 后 台 。 

在 游戏 中 只 需要 将 此 函数 设置 在 主 视 图 MySurfaceView 的 构造 函数 中 即 可 ; 


public boolean onKeyDown (int keyCode, KeyEvent event) { 
// 处 理 back 返回 按键 
if (keyCode == KeyEvent .KEYCODE BACK) { 
// 游 戏 胜利 、 失 败 、 进 行 时 都 默认 返回 菜单 
if (9ameState == GAMEING || gameState == GAME WIN | | 
9ameState == GAME LOST) { 
gameState = GAME MENU; 
isBoss=false; 
// 重 置 游戏 
initGame (); 
// 重 置 怪物 出 场 
enemyArrayIndex = 0; 
}else if(9ameState == GAME MENU){ 
// 当 前 游戏 状态 在 菜单 界面 ， 默 认 返 回 按键 退出 游戏 
MainActivity.instance.finish(); 
System.exit (0); 


} 
// 表 示 此 按键 已 处 理 ， 不 再 交 给 系统 处 理 ， 
// 从 而 避免 游戏 被 切入 后 台 


return true; 


这 里 需要 注意 ， 虽 然 处 理 了 Back 按键 ， 但 发 现 是 没有 效果 的 。 如 果 既 想 处 理 Back 事 
件 ， 又 不 让 系统 将 应 用 切入 后 台 ， 除 了 获取 Back 按键 事件 后 利用 return true 处 理 外 ， 还 要 让 
当前 视图 〈 游 戏 主 视图 ) 设置 以 下 函数 : 


setFocusableInTouchMode (true) ; 
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5.6.2 ”为 游戏 设置 背景 常 亮 
一 般 手机 应 用 运行 时 ， 在 用 户 没有 任何 操作 的 情况 下 ， 屏 幕 在 一 段 时 间 后 默认 进入 省 电 
(屏幕 变 暗 ) 、 锁 屏 模 式 ， 那 么 如 果 想 让 游戏 保持 背景 常 亮 的 话 ， 只 需要 调用 下 面 函数 即 可 : 
M view.View.setKeepScreenOn(boolean keepScreenOn) 


作用 : 保持 背景 灯光 常 亮 
参数 ，true 表示 设置 常 亮 ，false 表示 不 保持 。 默 认 不 保持 


与 . /本 章 小 结 


本 章 介绍 了 一 个 游戏 的 整体 开发 流程 ， 以 及 对 自 定义 类 的 封装 和 一 些 开发 过 程 中 应 该 注 
意 的 细节 处 理 ; 当然 在 此 项 目 中 只 做 了 一 个 关卡 ， 一 些 功能 没有 实现 ， 比 如 游戏 中 暂停 的 状 
态 、 游 戏 的 帮助 说 明 、 在 主 菜单 添加 退出 按钮 、 游 戏 的 背景 音乐 、 游 戏 的 存储 等 等 。 

但 是 这 些 没有 完成 的 部 分 并 不 影响 什么 ， 本 章节 重点 还 是 让 大 家 在 脑 中 形成 一 个 大 体 的 
游戏 框架 ， 只 要 基础 扎实 ， 在 此 基础 上 扩展 添加 功能 就 轻而易举 了 ; 有 兴趣 的 可 以 为 此 项 目 
去 修改 和 添加 新 功能 ， 让 游戏 更 加 丰富 完整 。 
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从 本 章节 可 以 学 习 到 ; 


学 360” 平滑 游 戏 导航 摇 杆 
学 多 触 点 实现 图 片 缩放 

学 触 屏 手势 识别 

学 加 速度 传感器 

学 9patch 工具 的 使 用 

学 代码 实现 截屏 功能 

学 效率 检视 工具 

学 游戏 视图 与 系统 组 件 共同 显示 
学 蓝牙 对 战 游戏 

学 网 络 游戏 开发 基础 

学 本 地 化 与 国际 化 
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站 .| ”360 平滑 游戏 导航 摇 杆 


在 Android 系统 中 很 多 机 型 是 没有 实体 导航 按键 的 ， 那 么 如 果 想 让 一 个 游戏 在 所 有 
Android 系统 的 机 型 上 运行 ， 就 要 利用 Android 系统 都 支持 触 屏 的 特点 来 进行 设计 。 既 然 所 有 
Android 系统 都 支持 触 屏 ， 那 么 就 可 以 想到 ， 在 屏幕 上 绘制 一 个 游戏 摇 杆 供用 户 操作 游戏 ， 
这 也 是 目前 Android 游戏 开发 中 最 常用 的 一 种 做 法 了 。 

下 面 就 来 实现 Android 手机 上 的 360” 平 滑 游戏 摇 杆 吧 ! 首先 观察 如 图 6-1 所 示 的 效果 。 


图 6-1 摇 杆 示意 图 
图 6-1 是 一 个 摇 杆 的 示意 图 ， 从 图 中 加 以 分 析 : 


® 玩家 操作 的 应 该 是 中 心 红 色 的 小 辆 ; 

e 小 圆 的 最 大 活动 范围 是 围绕 大 圆 做 圆周 运动 ; 

e 既然 小 圆 有 活动 范围 ， 那 么 当 用 户 的 触 屏 点 在 大 圆 以 外 的 位 置 ， 那 么 小 圆 的 角度 应 该 
与 用 户 触 点 的 角度 相同 。 


首先 实现 的 应 该 是 在 屏幕 上 绘制 两 个 大 小 不 一 的 圆 形 ， 并 且 让 小 圆 中 心 点 围绕 大 圆 做 圆 
周 运 动 。 

新 建 项 目 “RockerProject”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代码 为 
“6-1 (360” 平滑 游戏 摇 杆 ) ”。 

修改 MySurfaceView: 
// 定 义 两 个 圆 形 的 中 心 点 坐标 与 半径 
Private float smallCenterX = 120，smallCenterY = 120, 


smallCenterR = 20; 
Private float BigCenterX = 120, BigCenterY = 120, 
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BigCenterR = 40; 
// 当 前 圆周 运动 的 角度 


Private int angle; 


// 修 改 绘图 函数 : 
Public void myDraw() { 


// 绘 制 大 圆 
paint.setAlpha (0x77) 
canvas.drawCircle (BigCenterX, BigCenterY, BigCenterR, paint); 


// 绘 制 小 圆 


canvas.drawCircle(smallCenterX, smallCenterY, smallCenterR, paint); 


新 封装 一 个 圆周 运动 时 ， 得 到 小 圆 坐标 的 方法 : 


小 圆 针 对 于 大 圆 做 圆周 运动 时 ， 设 置 小 圆 中 心 点 的 坐标 位 置 
@param centerX 

围绕 的 圆 形 (大 圆 ) 中 心 点 X 坐标 
@param centerY 


围绕 的 圆 形 (大 圆 ) 中 心 点 Y 坐标 
围绕 的 圆 形 (大 圆 ) 半径 


Public void setSmallCirclexY (float CenterX，float centerY, float R, 
double rad) { 

// 获 取 圆 周 运 动 的 X 坐标 

smallCenterX = (float) (R * Math.cos(rad)) + centerx; 

// 获 取 圆 周 运动 的 Y 坐标 

smallCenterY = (float) (R * Math.sin(rad)) + centerY; 


这 里 是 根据 角度 弧度 的 转换 ， 青 通过 三 角 函 数 定理 得 到 小 圆 坐 标 位 置 的 。 
逻辑 函数 : 
Private void logic() { 
// 让 角度 在 0~360 循环 
anglet++; 
if (angle >= 360) { 
angle = 0; 


) 
// 弧 度 = 角度 PI/*180 
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setSmallCircleXY (BigCenterxXx, BigCenterY, BigCenterR, 
angle * Math.PI / 180); 
} 


运行 项 目 ， 效 果 如 图 6-2 所 示 。 


图 6-2 圆周 运动 
此 步 完 成 之 后 ， 下 面 就 应 该 考虑 用 户 触 点 的 位 置 ， 大 概 分 为 两 种 情况 : 


@ 用 户 触 点 位 置 在 大 圆 内 或 者 大 圆 上 ， 那 么 小 圆 的 中 心 点 直接 跟随 玩家 触 点 位 置 即 可 ; 
@ 用 户 触 点 位 置 在 大 圆 外 ， 那 么 小 圆 中 心 肯定 在 大 圆 的 圆周 上 ， 但 是 小 圆 所 在 大 圆 上 的 
角度 ， 应 该 等 同 于 用 户 触 点 位 置 相对 于 大 圆 的 角度 。 


首先 删 去 刚才 在 逻辑 函数 中 的 代码 ， 然 后 封装 一 个 得 到 玩家 触 点 相对 于 大 圆 角 度 的 方 


* 得 到 两 点 之 间 的 弧度 
* @param pxl 第 一 个 点 的 X 坐标 
* param pyl 第 一 个 点 的 Y 华 标 
* @param px2 第 二 个 点 的 X 坐标 
* @param py2 第 二 个 点 的 Y 坐标 
* @return 
Sy 
public double getRad(float pxl, float pyl, float px2, float py2) { 
// 得 到 两 点 X 的 距离 
float x = px2 = pxl; 
// 得 到 两 点 Y 的 距离 
float y = pyl - py2; 
// 算 出 斜 边 长 
float Hypotenuse = (float) Math.sqrt(Math.Pow(X，2) + Math.pow(y,2)); 
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// 得 到 这 个 角度 的 余弦 值 (通过 三 角 函 数 中 的 定理 : 邻 边 / 斜 边 = 角度 余弦 值 ) 
float cosAngle = x / Hypotenuse; 
// 通 过 反 余弦 定理 获取 其 角度 的 弧度 
float rad = (float) Math.acos(cosAngle); 
// 当 触 屏 的 位 置 Y 坐标 < 摇 杆 的 Y 坐标 ， 取 反 值 -0~-180 
if (py2 < py1) { 
rad = -rad; 
} 
return rad; 


修改 触 屏 监听 函数 : 


public boolean onTouchEvent (MotionEvent event) { 
// 当 用 户 手指 抬 起 ， 应 该 恢复 小 圆 到 初始 位 置 
if (event .getRction() == MotionEvent .ACTION UP) { 
smallCenterX = BigCenterx; 
smallCenterY = BigCenterYy; 
} else { 
int PointX = (int) event .getx(); 
int pointY = (int) event .getY(); 
// 判 断 用 户 点 击 的 位 置 是 否 在 大 圆 内 
if (Math.sqrt(Math.pow((BigCenterX - (int) event.getX())，2) + 
Math.pow((BigCenterY - (int) event.getY())，2)) <= BigCenterR) { 
// 让 小 圆 跟 随 用 户 触 点 位 置 移动 
smallCenterX = pointx; 
smallCenterY = pointyYy; 
} else { 
setSmallCirclexY (BigCenterX, BigCenterY, BigCenterR, 
getRad (BigCenterX, BigCenterY, pointX, pointYy)); 


return true; 


运行 项 目 ， 效 果 如 图 6-3 所 示 。 

到 此 整个 摇 杆 的 制作 就 完成 了 ， 那 么 如 何在 游戏 中 使 用 它 呢 ? 其 实 很 简单 。 

假如 需要 使 用 摇 杆 控制 游戏 主角 的 移动 ， 那 么 首先 将 整个 360” 分 成 4 等 分 或 者 8 等 
分 ， 对 应 主角 的 4 方向 或 者 8 方向 ;然后 通过 封装 的 两 点 之 间 得 到 弧度 的 函数 获取 摇 杆 弧 
度 ， 将 其 弧度 转换 成 角度 ， 再 将 摇 杆 的 角度 与 之 前 的 360” 分 成 的 4 或 8 等 分 范围 比 对 处 理 
即 可 。 
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图 6-3 360” 平滑 游戏 摇 杆 


多 触 点 实现 图 片 缩放 


在 Android SDK 2.0 中 ， 对 应 API 5 时 开始 支持 屏幕 的 多 触 点 ， 不 过 真 机 测试 发 现 ， 目 前 
最 多 支持 两 个 触 点 ， 本 小 节 就 利用 多 触 点 的 功能 来 实现 缩放 位 图 。 

新 建 项 目 “MoreContactsProject”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 对 应 的 项 目 源 代 
码 码 为 “6-2 (多 触 点 缩放 位 图 ) ”; 这 里 需要 注意 ， 多 触 点 是 API 5 以 后 支持 的 功能 ， 所 以 
Android 模拟 器 要 选择 SDK 5 或 以 上 的 版 本 ， 和 否则 运行 项 目 会 报错 。 

首先 定义 用 到 的 成 员 变量 : 
// 声 明 一 张 icon 位 图 
Private Bitmap bmpIcon=BitmapFactory.decodeResource (this.getResources ()， 

R.drawable.icon); 


// 记 录 两 个 触 屏 点 的 坐标 
Private int xl, x2, yl, y2; 
/ /倍率 

private float rate = 1; 

// 记 录 上 次 的 倍率 


Private float oldRate = 1; 

/ /记录 第 一 次 触 屏 时 线段 的 长 度 
Private float oldLineDistance; 
// 判 定 是 否 头 次 多 指 触 点 屏幕 


Private boolean isFirst = true; 


绘图 函数 : 
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Public void myDraw() { 


canvas.save(); 

// 缩 放 画 布 ( 以 图 片 中 心 点 进行 缩放 ，X、Y 轴 缩 放 比 例 相同 ) 

canvas.scale(rate, rate, screenW / 2, screenH / 2); 

// 绘 制 位 图 icon 

canvas.drawBitmap (bmpIcon, screenW / 2 - bmpIcon.getwidth() / 2, 
screenH / 2 - bmpIcon.getHeight() / 2, paint); 

canvas.restore(); 

// 便 于 观察 ， 这 里 绘制 两 个 触 点 时 形成 的 线段 


canvas.drawLine (x1l, yl, x2, y2, paint); 


触 屏 监 听 事 件 : 


public boolean onTouchEvent (MotionEvent event) { 
// 用 户 手指 抬 起 默认 还 原 为 第 一 次 触 屏 标识 位 ， 并 且 保存 本 次 的 缩放 比例 
if (event .getRction() == MotionEvent .ACTION UP) { 
isFirst = true; 
oldRate = rate; 
} else { 
xl = (int) event.getX(0) 
yl = (int) event.getY(0); 
x2 = (int) event.getX(1) 
y2 = (int) event.getYy(1); 
if (event.getPointerCount() == 2) { 
Ee (LisFiret) 1 
// 得 到 第 一 次 触 屏 时 线段 的 长 度 
oldLineDistance = (float)Math. sqrt 
(Math.pow(event.getX(1) - event.getX(0)，2) + 
Math.pow(event .getY(1) - event.getY(0), 2)); 
isFirst = false; 
} else { 
// 得 到 非 第 一 次 触 屏 时 线段 的 长 度 
float newLineDistance = (float) Math.sgrt 
(Math.pow(event.getX(1) - event.getxX(0), 2) + 
Math.pow(event .getY(1) - event.getY(0), 2)); 
// 获 取 本 次 的 缩放 比例 


rate = oldRate * newLineDistance/oldLineDistance; 


上 面 代码 中 ， 使 用 了 两 个 常用 的 函数 获取 触 屏 点 的 X、Y 坐标 : 
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MW MotionEvent.getX (int pointerIndex) 
作用 : 获取 触 屏 点 的 X 坐标 
参数 : 触 屏 点 下 标 〈 下 标 从 0 开始 ) 
M MotionEvent.getY (int pointerIndex ) 
作用 : 获取 触 屏 点 的 Y 坐标 
参数 : 触 屏 点 下 标 〈 下 标 从 0 开始 ) 


除 此 之 外 ， 常 用 的 方法 还 有 获取 触 屏 点 的 压力 值 函数 : 
M float getPressure (int pointerIndex ) 

作用 : 获取 触 屏 点 的 压力 值 

参数 ， 触 屏 点 下 标 下 标 从 0 开始 ) 
运行 项 目 ， 效 果 如 图 6-4 所 示 。 


图 6-4 多 点 缩放 位 图 
图 6-4 是 由 真 机 截图 得 到 的 效果 ， 因 为 模拟 器 无 法 模拟 多 点 触 屏 的 效果 。 


0 .3 触 屏 手势 识别 


所 谓 手 势 操 作 ， 类 似 跳舞 机 、Ezdancer 这 些 利用 不 同 动作 和 音符 让 人 手舞足蹈 ，Android 
提供 的 的 手势 也 让 其 平台 的 游戏 和 软件 有 了 更 多 的 花样 操作 和 玩法 。 

手势 的 识别 是 根据 玩家 接触 屏幕 时 间 的 长 短 、 在 屏幕 上 滑动 的 距离 、 按 下 抬 起 的 时 间 等 
进行 包装 ， 其 实 就 是 Android 对 触 屏 事 件 监听 做 了 包装 和 处 理 。 

Android 的 手势 功能 不 光 在 软件 开发 中 会 用 到 ， 还 经 常 应 用 在 浏览 器 中 的 翻 页 ， 滚 动 页 
面 等 操作 中 ; 如 果 在 开发 Android 游戏 时 ， 加 上 Android 手势 功能 会 让 游戏 增加 一 个 亮点 ， 
比如 一 般 的 CAG、PUZ 等 类 型 的 游戏 选择 关卡 ， 简 单 背 景 的 移动 等 都 可 以 使 用 手势 来 操作 。 
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如 果 需 要 监听 当前 用 户 的 手势 ， 首 先 需要 一 个 监听 接口 : 
GestureDetector .OnGestureListener 
使 用 此 接口 ， 需 要 重 写 6 个 抽象 函数 ， 所 有 重 写 函数 如 下 : 


// 按 下 

QOverride 

public boolean onDown (MotionEvent e) { 
return false; 


} 

// 短暂 按 下 抬 起 

Qoverride 

Pub1lic boolean onSingleTapUp (MotionEvent e) { 
return false; 


} 
// 先 短暂 按 下 、 然 后 滑动 、 最 后 抬 起 
Qoverride 
public boolean onFling(MotionEvent el, MotionEvent e2, float 
velocityX, float velocityY) { 
return false; 


} 
// 先 短 暂 按 下 、 然 后 滑动 
QOverride 
public boolean onScroll (MotionEvent el, MotionEvent e2, float 
distancex, float distanceY) { 
return false; 


} 

// 先 短暂 按 下 、 短 按 不 滑动 

@Override 

Public void onShowPress (MotionEvent e) { 


} 

// 长 按 不 滑动 

QOverride 

Public void onLongPress (MotionEvent e) { 
} 


写 监听 器 的 6 个 抽象 函数 如 上 都 做 了 简单 的 解释 ， 下 面 解 释 其 重 写 函数 中 参数 所 表达 
的 含义 : 
®。 e: 保存 触 屏 动作 信息 和 和 触 屏 点 坐标 等 ; 
® el: 保存 触 屏 按 下 的 动作 信息 和 点 坐标 等 ; 
e。 e2: 保存 触 屏 抬 起 的 动作 信息 和 点 坐标 等 ; 
e@ velocityX: 义 轴 上 的 移动 速度 ， 像 素 /s; 
. 
. 


本 


velocityY: 立轴 上 的 移动 速度 ， 像 素 /S; 
distanceX: 现 对 于 上 次 此 事件 触发 ，X 轴 发 生 偏 移 量 ; 
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e distanceY: 现 对 于 上 次 此 事件 触发 ，Y 轴 发 生 偏 移 量 ; 
®@ distanceX 与 distanceY: 千 万 不 要 理解 为 e2 点 又 或 了 坐标 与 el 点 X 或 了 坐标 的 距离 。 


除了 要 使 用 手势 监听 器 接口 外 ， 还 需要 一 个 触 屏 监听 器 接口 : 
View.OnTouchListener 


使 用 触 屏 监听 器 接口 还 需 重 写 一 个 抽象 函数 : 


public boolean onTouch(View v, MotionEvent event) { 
return false; 
} 


-开始 介绍 手势 时 说 过 ， 所 谓 手势 其 实 就 是 Android 对 触 屏 事件 的 封装 ， 所 以 在 监听 用 
户 的 动作 匹配 哪 种 手势 时 ， 必 须知 道 用 户 的 触 屏 信息 ; 而 这 个 触 屏 信息 ， 则 由 触 屏 监听 器 提 
供 ， 用 户 的 信息 都 存放 在 触 屏 监听 器 接口 的 抽象 方法 onTouch 的 参数 中 ， 所 以 应 该 修改 
onTouch 函数 如 下 : 


Public boolean onTouch (View v, MotionEvent event) { 
return GestureDetector.onTouchEvent (event); 
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实现 了 两 个 监听 器 之 后 ， 还 要 对 当前 的 视图 进行 绑 定 。 

手势 类 GestureDetector 构造 函数 : 

GS GestureDetector.GestureDetector (OnGestureListener listener ) 

作用 : 为 当前 视图 设置 手势 监听 器 
参数 : 手势 监听 器 
为 本 视图 设置 触 屏 监听 器 : 
M view.View.setOnTouchListener (OnTouchListener 1) 
作用 : 为 当前 View 设置 触 屏 监听 器 
参数 : 触 屏 监听 器 实例 

下 面 简 单 地 实现 一 个 利用 手势 操作 ， 匹 配 用 户 动 作 是 : “ 先 短暂 按 下 ， 然 后 滑动 ， 最 后 
抬 起 (onFling) ”， 不 断 地 在 画布 上 绘制 图 片 icon 的 小 例子 。 

新 建 项 目 “GestureProject”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代码 为 
“6-3〈 触 屏 手 势 识别 ) ”。 本 视图 使 用 触 屏 监听 接口 与 手势 监听 接口 ， 以 及 使 用 接口 要 重 写 
的 函数 ， 如 不 需要 修改 的 就 不 再 贴 出 代码 。 

修改 MySurfaceView 类 : 

// 检 测 手势 的 类 
Private GestureDetector gesture; 


// 保 存 所 有 添加 的 icon 位 图 


private Vector<Bitmap> vec = new Vector<Bitmap>(); 
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构造 函数 : 


Public MySurfaceView (Context context) { 
super (context); 


// 实 例 GestureDetector 
gesture = new GestureDetector (this); 
// 为 当前 视图 设置 触 屏 监听 器 


this.setOnTouchListener (this) ; 


绘图 函数 : 
Public void myDraw() { 


for (int i = 0; i < vec.size(); i++) { 
canvas .drawBitmap (vec.elementAt (i), i * 5, 50, paint); 


手势 onFling 函数 : 


// 先 短 暂 按 下 ， 然 后 滑动 ， 最 后 抬 起 
Public boolean onFling (MotionEvent el, MotionEvent e2, float 
velocityX, float velocityY) { 

// 往 图 片 容器 里 添加 一 个 新 的 icon 位 图 

vec.add (BitmapFactory.decodeResource (this.getResources () ， 
R.drawable.icon)) 

return false; 


项 目 运 行 效果 如 图 6-5 所 示 。 


图 6-5 触 屏 手势 识别 
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〇 .A 加 速度 传感器 


“传感器 ”一 词 对 于 接触 过 Android 系统 的 人 来 说 一 定 不 会 陌生 ， 比 如 常见 的 赛车 游 
戏 ， 很 多 都 使 用 了 传感器 的 功能 ， 不 需要 操作 任何 按键 ， 只 需要 通过 摇晃 手机 即 可 操控 赛车 
的 方向 ， 这 就 是 Android 传感器 中 的 一 种 加 速度 传感器 。 

加 速度 传感器 又 称 为 重力 传感器 ， 是 Android 系统 提供 传感器 中 的 一 种 ， 除 了 加 速度 传 
感 器 外 还 有 陀螺 仪 传感器 、 光 传感器 、 恒 定 磁场 传感器 、 方 向 传感器 、 人 恒定 的 压力 传 感 
器 、 接 近 传感器 和 温度 传感器 。 

本 章节 通过 详细 讲解 加 速度 传感器 ， 让 读者 熟 习 实现 一 个 传感器 的 过 程 与 步 又， 其 他 传 
感 器 的 实现 也 都 类 似 。 

首先 熟 习 几 个 有 关 传 感 器 的 类 与 接口 。 

1. SensorManager 

传感器 管理 类 ， 传 感 器 的 实例 是 通过 传感器 管理 类 来 获取 的 ; 实例 方式 是 通过 系统 提供 
的 传感器 服务 获取 传感器 管理 类 实例 的 。 


SensorManager sm = (SensorManager) MainRctivity; 
instance.getSystemService (Service.SENSOR SERVICE) ; 


2. Sensor 
传感器 类 ， 所 有 类 型 的 传感器 都 包含 在 此 类 中 ; 实例 方式 是 通过 传感器 管理 类 来 得 的 。 


Sensor sensor = SensorManager.getDefaultSensor (int type) ; 


代码 中 的 参数 int type 指 传感器 的 类 型 ， 其 值 是 在 Sensor 类 定义 的 静态 常量 。 


TYPE_ACCELEROMETER: 加 速度 传感器 (重力 传感器 ) 类 型 ; 
TYPE_ALL: 描述 所 有 类 型 的 传感器 ; 

TYPE_GYROSCOPE: 陀螺 仪 传感器 类 型 ; 

TYPE_LIGHT: 光 传 感 器 类 型 ; 

TYPE MAGNETIC_FIELD: 恒定 磁场 传感器 类 型 ; 
TYPE_ORIENTATION: 方向 传感器 类 型 ; 

TYPE_PRESSURE: 恒定 压力 传感器 类 型 ; 

TYPE_PROXIMITY: 常量 描述 型 接近 传感器 ; 
TYPE_TEMPERATURE: 温度 传感器 类 型 描述 。 


3. SensorEventListener 


传感器 监听 接口 ， 通 过 使 用 此 接口 可 以 监听 当前 传感器 的 属性 及 状态 。 
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使 用 传感器 监听 器 接口 ， 需 要 实现 以 下 两 个 函数 : 
// 传 感 器 获取 值 发 生 改 变 时 响应 此 函数 


public void onSensorChanged(SensorEvent event) {} 
// 传 感 器 的 精度 发 生 改变 时 响应 此 函数 


public void onAccuracyChanged(Sensor sensor, int accuracy) {} 


一 般 传 感 器 拥有 3 个 值 ， 除 了 X、Y 外 还 有 一 个 Z 值 ，Z 值 表示 屏幕 的 朝向 。 这 些 值 存 
放 在 SensorEvent 的 属性 value 数组 中 ， 获 取 的 方法 如 下 : 
int x = SensorEvent .values[0]; // 手 机 横向 翻滚 


int y = SensorEvent.values[1]; // 手 机 纵向 翻滚 
int z = SensorEvent .values [2]; // 屏 幕 的 朝向 


e@ x>0 说 明 当前 手机 左 翻 ，x<0 右 翻 ; 
e@ y>0 说 明 当 前 手机 下 翻 ，y<0 上 翻 ; 
@ Z>0 手机 屏幕 朝 上 ，z<0 手机 屏幕 朝 下 。 


注意 : 当前 手机 处 于 纵向 还 是 横向 ， 都 会 影响 X、Y 表示 的 意思 ! 
如 果 当 前 手机 是 纵向 屏幕 : 

e@ x>0 说 明 当 前 手机 左 翻 ，x<0 右 翻 ; 

e yY>0 说 明 当 前 手机 下 翻 ，y<0 上 翻 。 


如 果 当 前 手机 是 横向 屏幕 : 


ex>0 说 明 当前 手机 下 翻 ，x<0 上 翻 ; 

@ y>0 说 明 当 前 手机 右 翻 ，y<0 左 翻 。 

在 使 用 了 传 感 监听 器 后 ， 还 要 为 传感器 注册 上 监听 器 才能 完成 监听 ; 
SensorManager.registerListener(SensorEventListener listener,Sensor sensor, int rate) 
作用 : 为 传感器 注册 传 感 监听 器 ; 

第 一 个 参数 ， 传 感 监听 器 实例 

第 二 个 参数 ， 需 要 监听 的 传感器 实例 

第 三 个 参数 : 监听 传感器 速率 类 型 

监听 器 的 速率 类 型 如 下 : 

e SENSOR_DELAY_NORMAL: 正常 ; 

e@ SENSOR_DELAY _UI: 适合 界面 ; 

e@ SENSOR_DELAY _ GAME: 适用 于 游戏 ; 

e SENSOR DELAY_FASTEST: 最 快 。 


下 面 利 用 加 速度 传感器 实现 一 个 操作 圆 形 小 球 移动 的 小 游戏 。 
新 建 项 目 “SensorProject”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 对 应 的 源 代码 为 “6-4 
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〈 加 速度 传感器 ) ”。 
修改 MySurfaceView， 首 先 定义 一 些 用 到 的 成 员 变 量 : 


// 声 明 一 个 传感器 管理 器 

Private SensorManager sm; 

// 声 明 一 个 传感器 

Private Sensor sensor; 

// 声 明 一 个 传感器 监听 器 

Private SensorEventListener mySensorListener; 
// 圆 形 的 x、Y 坐标 

Private int arc x, arc y; 

// 传 感 器 的 x、y、z 值 

Private float x = 0, y= 0,z= 0; 


构造 函数 : 


Public MYSurfaceView(Context context) { 


// 获 取 传感器 管理 类 实例 
sm = (SensorManager) MainActivity.instance. 
getSystemService (Service.SENSOR SERVICE) ; 
// 实 例 一 个 重力 传感器 实例 
sensor = sm.getDefaultSensor (Sensor.TYPE ACCELEROMETER); 
// 实 例 传感器 监听 器 
mySensorListener = new SensorEventListener() { 
Q@Override 
// 传 感 器 获取 值 发 生 改 变 时 在 响应 此 函数 
Public void onSensorChanged (SensorEvent event) { 
x = event.values[0]; // 手 机 横向 翻滚 
//x>0 说 明 当 前 手机 左 翻 ，x<0 右 翻 
y = event .values[1]; // 手 机 纵向 翻滚 
//Y>0 说 明 当前 手机 下 翻 ，y<0 上 翻 
z = event .values[2]; // 屏 幕 的 朝向 
//z>0 手机 屏幕 彰 上 ，z<0 手机 屏幕 朝 下 
aTOL X= XR 
arc y= y; 
, 
@Override 
// 传 感 器 的 精度 发 生 改变 时 响应 此 函数 
Public void onAccuracyChanged (Sensor sensor, int accuracy) { 


} 
}; 
// 为 传感器 注册 监听 器 


sm.registerListener (mySensorListener, sensor, SensorManager. 
SENSOR DELAY GAME); 


276 


第 6 章 ”游戏 开发 提高 篇 


绘图 函数 : 
Public void myDraw() { 


Paint .setColor (Color .RED) ; 
Canvas.drawArc (new RectF(arc x arc y, arc x + 50, arc y + 50), 
0, 360, true, paint); 
paint.setColor (Color. YELLOW); 
canvas.drawText ("当前 重力 传感器 的 值 :"，arc x - 50, arc y - 30, paint); 
Canvas.drawText ("x=" + x + "y=" + y+ ",z=" + Zz, arc x =- 50, arcy, 
paint); 
String temp_str = "Himi 提示 : "; 
String temp str2 = ""; 
String temp str3 = ""; 
if (x<1 geEx> -1 eg&y<1 eg y> -1) 1{ 
temp_str += "当前 手机 处 于 水 平 放置 的 状态 "; 
:0 
temp_str2 += "并 且 屏 幕 朝 上 "; 
} else { 
temp_str2 += "并 且 屏 幕 朝 下 ,提示 别 躺 着 玩 手机 ， 对 眼睛 不 好 哟 "， 
} 
} else { 
Fo 
temp_str2 += "当前 手机 处 于 向 左 翻 的 状态 "; 
} else if (x < -1) { 
temp_str2 += "当前 手机 处 于 向 右 翻 的 状态 "; 
} 
SE ye 
temp_str2 += "当前 手机 处 于 向 下 翻 的 状态 "; 
本 上 1 (Vv < = 
temp_str2 += "当前 手机 处 于 向 上 翻 的 状态 "; 


1 
EE (ze 
temp_str3 += "并 且 屏 幕 朝 上 "; 
} else { 
temp_str3 += "并 且 屏 幕 朝 下 , 提示 别 躺 着 玩 手机 ， 对 眼睛 不 好 哟 "， 
} 


Paint.setTextSize(10) 

canvas.drawText (temp_str, 0, 50, paint); 
canvas.drawText (temp_ str2, 0, 80, paint); 
canvas.drawText (temp_ str3, 0, 110, paint); 
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项 目 运 行 效果 如 图 6-6 所 示 。 


imi 提 示 : 当前 手机 处 于 水 平 放 置 的 状态 Himi 提 示 : 当前 手机 处 于 水 平 放置 的 状态 
拭 且 屏幕 彰 上 并 且 屏 幕 朝 下 ,提示 别 躺 着 玩 手机 ， 对 眼睛 不 好 哟 ~ 


当前 重力 传感器 的 值 : 
x=-0.7218784,y=0.7218784,2=10.119919 
当前 重力 传感器 的 值 : 


X=-0.6946377,y=0.7627395,7=-9,302697 


6-6 加 速度 传感器 


9patch 工具 的 使 用 


9patch: 是 一 个 对 png 图 片 做 处 理 的 工具 ， 能 够 生成 “*.9.png” 格 式 的 图 片 ; 

“*.9.png” 格 式 是 Android OS 支持 的 一 种 特殊 的 图 片 格式 ， 用 它 可 以 实现 部 分 拉 伸 。 因 
为 是 经 过 “9patch 工具 ”进行 特殊 处 理 过 的 ， 所 以 能 很 好 地 解决 一 般 png 格式 图 拉 伸 会 失 
真 、 拉 伸 不 正常 的 问题 。 

在 Android SDK 路 径 下 的 tools 目录 下 的 “draw9patch.bat”， 就 是 9patch 工具 ， 官 方 名 
为 NinePatch。 双 击 “draw9patch.bat” 则 启动 9patch 工具 ， 界 面 如 图 6-7 所 示 。 

单 击 菜单 “file” 选 项 ， 选 中 “Open 9-patch..….” 选 项 ， 导 入 一 张 png 图 片 ， 然 后 真正 进 
入 9patch 的 操作 界面 (如 图 6-8 所 示 ) : 
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— 


园 Draw 9-patch Bs 


Fle 
Prass Shift te ersse pizels (DD) [She bad patcher | | TT 


图 6-8 ”9patch 操作 界面 


序号 @: 在 拉 伸 区 域 周围 用 红色 边框 显示 拉 伸 后 的 图 片 可 能 会 产生 变形 的 区 域 ， 如 果 完 
全 消除 该 内 容 则 图 片 拉 伸 后 是 没有 变形 的 ， 也 就 是 说 ， 不 管 如 何 缩 放 图 片 显 示 都 是 良好 的 
(实际 测试 发 现 NinePatch 编辑 器 是 根据 图 片 的 颜色 值 来 区 分 是 否 为 bad patch 的 ， 一 般 只 要 色 
差 不 是 太 大 不 用 考虑 这 个 设置 ) 。 

序号 @: 是 导入 的 图 片 ， 以 及 可 操作 区 域 。 

序号 @: 这 里 zoom 的 长 条 bar 是 对 导入 的 图 进行 放大 缩小 操作 ， 这 里 的 放大 缩小 只 是 为 
了 让 使 用 者 更 方便 ， 毕 竟 对 像素 点 操作 比较 费 神 ， 下 面 的 patch scale 是 序列 @ 区 域 中 的 3 种 
形态 拉 伸 后 的 一 个 预览 操作 ， 可 以 看 到 图 片 拉 伸 后 的 效果 。 

序号 四 : 从 上 到 下 依次 为 纵向 拉 伸 的 效果 预览 、 横 向 拉 伸 的 效果 预览 以 及 整体 拉 伸 的 效 
果 预 览 。 

序号 @: 如 果 勾 选 上 ， 那 么 当 鼠 标 放 在 @ 区 域内 的 时 候 ， 当 前 位 置 为 不 可 操作 区 域 且 
会 出 现 一 张 lock 的 图 。 
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序号 @: 如 果 勾 选 上 ， 那 么 在 @ 区 域 中 就 会 看 到 当前 操作 的 像素 点 在 拉 伸 预 览 图 中 的 相 
对 位 置 和 效果 。 

序号 @: 在 编辑 区 域 显示 图 片 拉 伸 的 区 域 。 

操作 : 鼠标 左 键 选取 需要 拉 伸 的 像素 点 ，shift+ 鼠 标 左 键 取消 当前 像素 点 。 

操作 区 域 : 如 图 6-9 所 示 。 


图 6-9 编辑 操作 区 域 


从 图 6-9 看 到 导入 的 png 图 片 默认 周围 多 了 一 圈 像 素 点 ， 这 一 圈 像 素 点 就 是 可 操作 区 
域 。 因 为 下 方 和 右 方 可 操作 区 域 是 指定 内 容 的 显示 区 域 ， 属 于 可 选区 域 ， 可 不 予 理 会 ， 但 是 
要 注意 内 容 区 域 的 标记 不 能 有 间断 ， 也 就 是 说 标记 要 连续 且 仅 有 一 处 ， 和 否则 “.9.png” 图 片 在 
放 入 项 目下 会 报错 。 

注意 left 和 top 操作 区 域 。top 操作 区 域 的 一 排 像 素 点 ， 表 示 横 向 拉 伸 的 像素 点 ，left 操 
作 区 域 的 一 排 像 素 点 ， 表 示 纵 向 拉 伸 的 像素 点 。 

代码 中 加 载 一 张 “.9.png” 图 的 步骤 如 下 : 


但 光 型 先 把 “.9.png” 图 资源 生成 一 张 Bitmap 位 图 ， 与 正常 图 片 加 载 方式 一 样 ; 
绘制 时 候 利 用 NinePatch 类 进行 绘制 


使 用 “*.9.png” 的 好 处 


1. 省 精力 和 时 间 

如 果 有 一 张 50X 50 的 类 似 上 面 那 种 带 花边 的 png 图 片 ， 那 么 在 Android 或 者 大 分 辩 率 的 
机 器 上 使 用 的 话 ， 肯 定 需要 让 美工 给 重新 做 一 张 ， 而 通过 9patch 处 理 得 到 的 “*.9.png” 就 会 
省 去 美工 不 少 工作 。 

2. 省 内 存 

如 果 不 想 用 代码 对 小 图 进行 缩放 以 再 次 使 用 《〈 因 为 考虑 会 失真 ) ， 可 能 会 多 加 图 片 ， 这 
样 一 来 游戏 包 的 大 小 就 会 增加 了 ， 几 KB 到 几 十 KB 不 等 ， 而 利用 9patch 处 理 就 省 去 了 这 些 
麻烦 ， 节 省 了 空间 。 
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3. 减少 代码 量 
有 些 人 会 说 ， 我 用 代码 一 样 能 实现 图 片 的 效果 不 失真 ， 没 错 ， 利 用 设置 可 视 区 域 等 代码 
可 以 实现 ， 但 可 以 肯定 的 是 没有 用 “.9.png” 的 方式 来 的 这 么 简单 方便 ! 
新 建 项 目 “NinePatchProject”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 对 应 的 源 代码 为 “6- 
5 《9patch 工具 ) ”。 
首先 导入 两 张 图 片 资源 (如 图 6-10 所 示 ) : 


图 6-10 图 片 资源 


图 6-10 中 左 侧 是 一 张 正常 的 png 图 片 ， 右 侧 是 通过 9patch 工具 处 理 过 的 “.9.png” 图 。 
声明 用 到 的 成 员 变 量 : 


// 原 图 

Private Bitmap bmp old; 

// 通 过 9patch 工具 生成 的 ".9.png” 图 
Private Bitmap bmp 9path; 

// 声 明 NinePatch 

Private NinePatch np; 


构造 函数 : 


Public MySurfaceView(Context context) { 


// 将 图 片 资源 生成 位 图 

bmp old = BitmapFactory.decodeResource (getResources(), 
R.drawable.iamge); 

bmp 9path = BitmapFactory.decodeResource (getResources ()， 
R.drawable.nine image); 

// 实 例 NinePatch 实例 

np = new NinePatch (bmp 9path, bmp 9path.getNinePatchChunk(), null); 


NinePatch 构造 函数 : 

SC NinePatch (Bitmap bitmap, byte[] chunk, String srcName) 

第 一 个 参数 : “.9.png” 的 位 图 实例 

第 二 个 参数 : 参数 其 实 要 求 传 入 处 理 拉 伸 方式 ， 当 然 不 需要 自己 传 入 ， 因 为 “.9.png” 
图 片 自身 有 这 些 信息 数据 ， 也 就 是 用 9patch 工具 操作 的 信息 ! 这 个 参数 直 
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接 用 “.9.png” 图 片 自身 的 数据 调用 getNinePatchChunk() 采 用 自身 操作 信息 
即 可 。 
第 三 个 参数 : 图 片 源 的 名 称 ， 这 个 参数 为 可 选 参数 ， 直 接 null 就 可 以 。 


绘图 函数 : 


public void myDraw() { 


canvas .drawColor (Color. BLACK); 
WW 这 里 是 为 了 更 好 地 展示 出 缩放 拉 伸 后 的 区 别 
RectF rectf old two = new RectF(0, 50, bmp old.getWidth() * 
2, 120 + bmp old.getHeight() * 2); 

RectF rectf old third = new RectF(0, 120 + bmp old.getHeight() 

* 2, bmp old.getNidth() * 3, 140 + bmp old.getHeight() * 2 + 

bmp old.getHeight ()* 3); 
// -------- 下 面 是 对 正常 Pag 绘画 方法 ----------- 
canvas.drawBitmap (bmp old, 0, 0, paint); 
canvas.drawBitmap (bmp_old, null, rectf old two, paint); 
canvas.drawBitmap (bmp_old, null, rectf old third, paint); 
RectF rectf 9path two = new RectF(250, 50, 250 + 

bmp 9path.getWidth() * 2, 90 + bmp 9path.getHeight() * 2); 
RectF rectf 9path third = new RectF(250, 120 + 

bmp 9path.getHeight() * 2, 250 + bmp 9path.getwidth() * 3, 

140 + bmp 9path.getHeight() * 2+ bmp 9path.getHeight ()*3); 

canvas.drawBitmap (bmp 9path, 250, 0, paint); 
1 一 一- 一 下 面 是 ".9.png" 图 像 的 绘画 方法 ----------- 
np.draw (canvas, rectf 9path two); 
np .draw (canvas, rectf 9path third); 


代码 中 使 用 了 绘制 位 图 的 方法 : 
M NinePatch.draw (Canvas canvas, RectF location) 
作用 : 绘制 “.9.png” 位 图 
第 一 个 参数 ， 画布 实例 
第 二 个 参数 : RectF 实例 
项 目 效果 如 图 6-11 所 示 。 
最 后 需要 提醒 一 点 : 千 万 不 要 随便 将 一 个 “.png” 格 式 的 图 片 改名 成 “.9.png” 格 式 ， 因 
为 不 是 通过 9patch 生成 的 “.9.png” 格 式 的 图 导入 在 项 目 中 时 ， 项 目 会 报错 ，ADT 会 检测 资 
源 文件 “.9.png” 图 是 否 由 9patch 生成 。 
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图 6-11 png 与 .9.png 拉 伸 效果 对 比 图 


代码 实现 截屏 功能 


在 体育 类 的 游戏 中 ， 例 如 篮球 游戏 ， 有 时 需要 实现 一 个 摄像 头 功能 ， 模 拟 现场 直播 的 效 
果 。 除 此 之 外 在 手机 网 游 中 很 多 时 候 也 需要 截屏 功能 ， 用 户 可 以 将 游戏 界面 截图 下 来 ， 然 后 
将 游戏 的 截图 分 享 或 者 上 传 等 。 

这 一 小 节 主 要 介绍 在 游戏 中 常用 的 代码 实现 截屏 的 方法 。 通 过 之 前 的 游戏 基础 的 章节 学 
习 可 以 知道 ， 想 在 视图 中 显示 绘制 的 图 形 或 者 位 图 等 ， 都 需要 得 到 一 个 画布 ， 然 后 通过 画布 
再 进行 绘制 。 截 屏 的 实现 原理 ， 其 实 就 是 通过 手动 创建 一 张 位 图 ， 然 后 通过 此 位 图 得 到 一 个 
Canvas (画布 ) 实例 ， 接 着 利用 得 到 的 这 个 画布 进行 绘制 ， 而 画布 上 绘制 的 这 些 图 形 其 实 都 
保存 在 最 初创 建 的 位 图 上 。 最 后 只 要 利用 游戏 主 画 布 绘制 这 张 位 图 即 可 。 

新 建 项 目 “ClipScreenProject”， 游 戏 框架 为 SurfaceView 框架 ， 对 应 的 源 代码 为 “6-6 
(截屏 ) ” 

修改 MySurfaceView 类 : 
//icon 位 图 
Private Bitmap bmpIcon; 
/ /截屏 的 图 
Private Bitmap bmpClip; 
/ /截屏 的 画布 


private Canvas canvasClip; 


视图 创建 函数 : 
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public void surfaceCreated (SurfaceHolder holder) { 


// 实 例 Icon 位 图 

bmpIcon = BitmapFactory.decodeResource 
(this.getResources(), R.drawable.icon); 

// 创 建 一 个 与 当前 屏幕 大 小 相同 的 图 片 

bmpClip = Bitmap.createBitmap (this.getWwidth(), this. 
getHeight (), Config.ARGB 8888); 

// 通 过 创建 的 图 片 ， 得 到 画布 实例 

canvasClip = new Canvas (bmpClip); 

// 利 用 截屏 画布 刷 屏 

canvasClip.drawColor (Color .WHITE); 

// 利 用 画布 绘制 一 张 icon 图 

canvasClip.drawBitmap (bmpIcon, 0, 0, paint); 


由 于 this.getWidth()、this.getHeight() 得 到 视图 宽 高 的 函数 ， 必 须 在 视图 创建 后 才能 正常 
得 到 其 值 ， 所 以 这 里 创建 截屏 位 图 的 代码 写 在 此 函数 中 。 


M Bitmap.createBitmap (int width, int height, Config config) 
作用 : 创建 一 张 位 图 
第 一 个 参数 : 位 图 宽 
第 二 个 参数 : 位 图 高 
第 三 个 参数 : 图 片 配置 信息 

M Canvas.Canvas (Bitmap bitmap ) 
作用 : 得 到 位 图 的 画布 实例 
第 一 个 参数 : 位 图 实例 

绘图 函数 : 

Public void myDraw() { 

// 绘 制 icon 位 图 
canvas.drawBitmap (bmpIcon, 0, 0, paint); 


// 绘 制 截 屏 的 位 图 
canvas.drawBitmap (bmpClip, 50, 50, paint); 


绘制 截屏 的 位 图 ， 其 实 就 是 绘制 截屏 的 画布 ， 而 截屏 中 绘制 的 icon 位 图 相对 于 截屏 画 
布 的 坐标 仍然 是 (0，0 ) 。 
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项 目 截图 效果 如 图 6-12 所 示 。 


图 6-12 截屏 效果 图 


图 6-12 白色 部 分 与 视图 大 小 相同 ， 但 是 从 屏幕 无 法 完整 地 看 出 整个 截屏 画布 的 大 小 ， 为 
便于 观察 ， 截 屏 画 布 并 没有 与 主 画布 重合 。 


效率 检视 工具 


程序 都 是 改 出 来 的 ， 而 流畅 的 程序 则 是 优化 出 来 的 ， 手 机 的 应 用 程序 也 是 如 此 。 不 管 是 
网 游 还 是 单机 游戏 还 是 应 用 ， 对 于 程序 的 内 存 和 代码 优化 都 是 必须 重视 的 。 

那么 优化 代码 应 该 如 何 下 手 ? 程序 中 哪 段 代码 或 者 哪个 函数 占用 了 更 多 的 运行 时 间 ? 
Android SDK 为 开发 者 提供 了 一 个 效率 检视 工具 一 一 TraceView! 

TraceView 是 Android 平台 提供 给 开发 者 的 一 个 很 好 的 性 能 分 析 工 具 ; 通过 TraceView 提 
供 的 图 形 化 方式 不 仅 让 开发 者 更 好 地 跟踪 程序 的 性 能 ， 而 且 还 能 具体 到 每 个 函数 的 性 能 信 
息 。 

使 用 TraceView 检测 一 个 程序 的 效率 ， 首 先 需 要 得 到 此 程序 的 追踪 文件 。 得 到 程序 的 追 
踪 文 件 很 简单 ， 只 要 调用 两 个 函数 即 可 。 


1 . 开始 记录 函数 


M Debug.startMethodTracing (String traceName) ; 
作用 : 开始 记录 程序 运行 信息 ， 并 且 在 “/sdcard ”目录 下 生成 一 个 追踪 文件 
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“traceName.trace” 
参数 : 追踪 文件 的 文件 名 
M Debug.startMethodTracing(); 
作用 : 开始 记录 程序 运行 信息 ， 并 且 默 认 在 “/sdcard” 目 录 下 生成 一 个 追踪 文件 
“dmtrace.trace” 


2， 停 止 记录 函数 


M Debug.stopMethodTracing(); 
作用 : 停止 记录 程序 运行 信息 
当 开 始 记 录 函 数 被 调用 之 后 ， 就 会 生成 此 追踪 文件 ， 但 是 在 停止 记录 函数 被 调用 之 前 ， 
追踪 文件 大 小 一 直 为 0， 没 有 任何 数据 ， 只 有 停止 记录 函数 被 调用 之 后 ， 系 统 才 会 将 记录 的 
数据 存放 在 监测 文件 中 。 
生成 追踪 文件 需要 注意 以 下 几 点 : 


(1) 必须 保证 Android 模拟 器 或 者 真 机 设备 中 有 SDCard， 因 为 生成 的 追踪 文件 默认 保存 
在 SDCard 中 。 

(2) 因为 追踪 文件 默认 保存 在 SDCard 中 ， 且 当 停 止 记录 后 会 把 记录 的 数据 存放 在 此 文 
件 中 ， 所 以 在 Mainfestmani.xml 中 添加 写 入 权限 : 
<uses-permission 


android:name="android.permission.WRITE EXTERNAL STORAGE"> 
</uses-permission> 


(3) 如 果 SDCard 空间 太 小 ， 则 程序 的 追踪 文件 记录 到 SDCard 容量 满 时 就 停止 记录 ， 
所 以 为 了 生成 一 个 正确 的 追踪 文件 ， 生 成 一 个 存储 空间 适合 的 SDCard 也 较为 重要 。 毕 竞 记 
录 的 时 间 越 长 ， 追 踪 文 件 也 就 越 大 。 

当 得 到 程序 的 追踪 文件 后 ， 将 追踪 文件 导出 到 电脑 中 。 这 里 编者 做 了 一 个 简单 的 测试 程 
序 ， 生 成 了 一 个 名 为 “himi.trace” 的 追踪 文件 ， 并 且 从 手机 SDCard 中 导出 存放 在 C 盘 根 目 
录 下 ， 那 么 通过 DOS 命令 启动 TraceView 来 解析 这 个 追踪 文件 : 


C:\Users\Himi>traceview c:\himi 


有 时 输入 命令 后 ， 并 没有 打开 TraceView 窗口 ， 而 是 报 出 如 图 6-13 所 示 的 错误 。 
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CGC: Users\Himi>traceuiew c:\himi 


IException in thread "main java.lang.OutOfMemoryError: Java heap space 
at java.util.Arrays.copyOf CUnknown Source> 
at java-.util.frrays.copyOf CUnknown Source» 
at java.util.fArrayList.ensureCapacityUnknown Source> 
at java.util.ArrayList.addUnknown Source» 


at com.android.traceview.DnIraceReader.getThreadTlimeRecords (DnTraceReadq 
r.java:527> 

at com.android.traceview.TimeLineView.<init>TimeLineUView.java:316> 

at com.android.traceview.MainWindow.createContentsMainWindow. .java:93> 

at org.eclipse.jface.window.Window.create Window.java:431> 

at org.eclipse.jface.window.Window.open Window.java:?7908> 

at com.android.traceview.MainWindow.runMainy 

at 


图 6-13 DOS 命令 异常 截图 


这 个 错误 的 解决 方案 是 : 到 SDK 路 径 的 tools 目录 下 找到 traceview.bat 文件 ， 单 击 鼠 标 
右键 ， 选 中 “编辑 ” (或 者 记事 本 打开 ) 选项 ， 然 后 将 其 中 的 最 后 一 行 替换 如 下 : 


call java -Xms128m -Xmx512m -Djava.ext.dirs=%javaextdirs%® -jar %jarpath%%* 


以 上 的 解决 方案 就 是 将 TraceView 的 运行 内 存 增 大 ， 避 免 出 现 内 存 溢出 错 i 
正常 情况 下 ， 在 DOS 界面 输入 命令 后 ， 等 待 2s 左右 ，TraceView 界面 就 会 
14 所 示 。 


现 ， 如 图 6- 


Traceview C\phimirace -= 


mon NN 
| lag ginger Thread | | HL 
His ginder Tresd a3| | 中 
mei wri 
5] HeapWorker 必 nl a n n 


0 Goplevel) is% 122541 
vaflang/Thread run OV ao 0062 

2 comhimi/MysurfaceView run OV 00% i174 
3 conVhimi/MySurtoceview draw OV Qi% S54 
4 comVhimiMySurfaceView hot lLandroid/graphics/Canva = 877% 6028766 = O09% 63023 


5 androd/graphics/BamapF actory decodeResou 


6 sndrerd/graphicwyBamapfacton decedeResou 


droid/9raphics/Bamapfactory decodeResource 
8 android/graphics/ Bam 


actony decodeseream (Lj 


cd/grephics/Btmapf actory nativeDecodeass. 


10 android/contert/res/Resourcet openRawResoure 


Find: 


图 6-14 TraceView 效率 检视 工具 
这 里 对 一 些 单词 含义 进行 简单 的 介绍 : 
@ Exclusive: 同 级 函数 本 身 运行 的 时 间 。 
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@ Inclusive: 除 统计 函数 本 身 运 行 的 时 间 外 再 加 上 调用 子 函 数 所 运行 的 时 间 。 

Name: 列 出 的 是 所 有 的 调用 项 ， 前 面 的 数字 是 编号 ， 展 开 可 以 看 到 有 Parent 和 
Children 子 项 ， 就 是 指 被 调用 和 调用 。 

Incl%: inclusive 时 间 占 总 时 间 的 百分比 。 

Excl%: 执行 占 总 时 间 的 百分比 。 

Time/Call: 总 的 时 间 ( ms) 。 

Calls+Recur Calls/Total: 调用 和 重复 调用 的 次 数 。 

max msec: 追踪 文件 记录 的 总 时 间 。 


从 图 6-14 所 示 的 TraceView 界面 中 ， 可 以 看 到 有 各 种 颜色 ， 每 种 颜色 代表 不 同 的 函数 和 
步骤 。 同 一 颜色 的 区 域 越 大 ， 就 代表 这 个 步骤 运行 时 间 越 长 。 

在 图 6-14 下 面 的 统计 表 中 ， 明 显 可 以 看 出 除了 序列 0、1 是 系统 函数 外 ， 序 列 2 和 3 函 
数 占用 的 时 间 比 较 长 (因为 是 游戏 的 主 逻 辑 和 主 绘图 函数 ) 。 仔 细 观 察 序列 4， 它 是 个 自 定 
义 的 函数 ， 名 为 “hot”， 它 占用 的 运行 时 间 几 乎 与 主线 程 / 主 函 数 的 时 间 一 样 了 ， 那 么 肯定 
有 必要 到 程序 中 查看 一 下 此 函数 的 实现 方法 。 其 实 这 个 方法 是 特意 编写 的 ， 就 是 为 了 来 演示 
TraceView， 这 个 hot 函数 的 代码 如 下 : 


public void hot (Canvas canvas) { 
for (inG dd = Tr dx L007 LH) 
Bitmap bmp = BitmapFactory.decodeResource (getResources () ， 
R.drawable.icon); 
canvas.drawBitmap(bmp, i += 2, i += 2, paint); 


这 个 hot 函数 在 每 次 调用 时 ， 都 会 在 画布 上 绘制 100 张 icon 图 ， 所 以 占用 了 较 多 的 运行 
时 间 。 

通过 上 述 讲 解 与 简单 的 测试 可 以 看 出 ，TraceView 是 个 非常 好 的 程序 监视 工具 ， 它 通过 
追踪 文件 生成 的 图 形 分 析 与 函数 列表 信息 ， 可 以 很 直观 地 帮助 开发 人 员 找 出 程序 运行 缓慢 的 
原因 ， 让 代码 不 断 改进 ， 程 序 不 断 完 善 。 


站 . 另 ”游戏 视图 与 系统 组 件 共同 显示 


在 游戏 开发 中 ， 有 时 想 直接 使 用 Android 提供 的 组 件 ， 比 如 按钮 、 文 本 编辑 框 等 ， 游 戏 
是 在 view 视图 中 进行 的 ， 那 么 添加 系统 组 件 的 话 ， 就 应 该 想到 将 游戏 自 定义 的 视图 view 作 
为 一 个 组 件 ， 与 系统 组 件 一 同 放 在 布局 中 ， 然 后 通过 Activity 显示 布局 一 并 显示 在 手机 屏幕 
2 
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大 概 想到 这 些 之 后 ， 下 面 就 来 简单 实现 一 个 手机 屏幕 既 显 示 游戏 view， 也 显示 系统 组 件 
的 例子 。 

新 建 项 目 “ViewAndItem”， 游 戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代码 为 
“6-8〔 游 戏 视图 与 系统 组 件 ) ”。 既 然 游戏 视图 与 系统 组 件 都 是 由 布局 一 起 显示 ， 那 么 首先 
修改 MainActivity 类 : 


public class MainActivity extends Activity { 
@Override 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
// 设 置 全 屏 
this .getWindow() .setFlags (WindowManager.LayoutParams . 
FLAG FULLSCREEN, WindowManager .LayoutParams . 
FLAG FULLSCREEN); 
requestWindowFeature (Window .FEATURE NO TITLE); 
// 显 示 main.xml 布局 文件 
setContentView(R.layout.main); 


然后 修改 res/layout 下 的 main.xml 布局 文件 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical”" android:layout width="fill parent" 
android:layout height="fill parent"> 
<!-- 自 定义 的 SurfaceView 视图 组 件 --> 
<com.vai.MySurfaceView android:layout width="wrap content" 
android:layout height="wrap content" android:text="@string/hello" 
android:id="@+id/myview" /> 
<Button android:layout width="wrap content" 
android:layout height="wrap content" android:text="Button”" 
android:layout alignParentBottom="true" /> 
</RelativeLayout> 


整个 布局 使 用 相对 布局 ， 其 中 包含 自 定义 的 SurfaceView 视图 和 系统 Button 按钮 ， 最 后 
- 步 ， 也 是 最 重要 的 一 步 ， 修 改 MySurfaceView 的 构造 函数 如 下 : 


public MySurfaceView(Context context, AttributeSet attrs) { 
super (context, attrs); 
} 


MySurfaceView 构造 函数 的 第 二 个 参数 指 自 定义 的 组 件 的 一 些 属性 ， 如 组 件 的 长 宽 等 ， 
自 定义 组 件 的 属性 其 实 就 是 通过 这 个 参数 进行 传递 的 。 
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项 目 运 行 效果 如 图 6-15 所 示 。 


这 里 是 游戏 视图 -SurfaceView 


图 6-15 游戏 视图 与 系统 组 件 


蓝牙 对 战 游戏 


由 于 Android 模拟 器 中 没有 蓝牙 模块 ， 请 读者 在 真 机 设备 上 进行 测试 ， 且 蓝牙 模块 只 有 
在 Android SDK 2.0 (API5) 以 上 ( 含 ) 版 本 才 开 始 支持 。 

首先 介绍 BluetoothAdapter〈 蓝 牙 适 配器 类 ) ， 这 个 类 对 蓝牙 当前 的 状态 是 否 可 见 、 是 否 
已 打开 等 进行 设置 与 监听 。BluetoothAdapter 的 实例 方法 如 下 : 


BluetoothAdapter ba = BluetoothAdapter.getDefaultAdapter(); 


BluetoothAdapter 的 常用 函数 如 下 : 


1. int BluetoothAdapter.getState() 
作用 : 获取 当前 终端 设备 蓝牙 状态 
返回 值 : int 常量 值 

蓝牙 开关 常量 如 下 : 


® BluetoothAdapter.STATE OFF = 10 [0xa] 
® BluetoothAdapter.STATE ON = 12 [0xc] 
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2. BluetoothAdapter.enable() 

作用 : 启动 蓝牙 

3. BluetoothAdapter.disable() 

作用 : 关闭 蓝牙 

4. BluetoothAdapter.startDiscovery() 

作用 : 启动 蓝牙 可 被 发 现 

5. BluetoothAdapter.getAddress() 

作用 : 得 到 当前 设备 蓝牙 地 址 

BluetoothDevice 是 蓝牙 设备 类 ， 其 构造 方法 如 下 : 

‘© BluetoothDevice bd = BluetoothAdaptergetRemoteDevice (String address) ; 
作用 : 获取 一 个 设备 实例 
参数 :设备 地 址 

BluetoothSocket 是 蓝牙 连接 类 ， 用 于 发 送 与 接受 报 文 数据 ， 其 构造 方法 如 下 : 

GC BluetoothSocket bs=BluetoothDevice.createRfcommSocketToServiceRecord(UUID uuid) 
作用 : 获取 一 个 蓝牙 连接 实例 
参数 : UUID 实例 


BluetoothDevice 的 常用 函数 如 下 : 


1. BluetoothSocket.connect() 
作用 : 与 此 蓝牙 设备 创建 连接 
2. BluetoothSocket.getInputStream() 
作用 : 得 到 一 个 输入 流 ， 用 于 监听》 获取 报 文 数 据 
此 方法 对 已 配对 的 蓝牙 设备 进行 监听 报 文 数据 ， 如 接收 到 数据 则 会 创建 得 到 一 个 输入 流 
实例 ， 用 于 读 取 报 文 数 据 ， 如 接收 不 到 报 文 数据 则 默认 阻塞 。 
3. BluetoothSocket.getOutputStream() 
作用 : 得 到 一 个 输出 流 ， 用 于 发 送 报 文 数据 
了 解 这 些 类 之 后 ， 下 面 就 通过 项 目 实例 详细 讲解 蓝牙 功能 的 开发 。 
- 般 开 发 蓝牙 需要 两 台 真 机 设备 ， 这 里 首先 讲解 如 何 利用 IVT 软件 与 蓝牙 适配器 模拟 一 
个 蓝牙 终端 (本 节 内 容 基 于 Windows7 系 统 ) 。 
首先 安装 Bluesoleil 软件 ， 成 功 安装 之 后 ， 将 蓝牙 适配器 连接 到 电脑 ， 然 后 右 击 任 务 栏 


的 IVT 图 标 轩 国 ， 选 中 “显示 经 典 界 面 ”选项 ， 然 后 在 IVT 主 菜单 中 依次 找到 “蓝牙 一 我 的 


属性 设备 一 串口 ”观察 当前 启动 的 串口 ， 记 住 默认 启动 的 是 com3 与 com4 串口 ， 以 便 后 续 的 
配置 。 

然后 安装 Windows NT 软件 ， 成 功 安装 后 单 击 Windows NT 目录 下 的 “hypertrm.exe” 文 
件 ， 出 现 位 置信 息 界面 ， 如 图 6-16 所 示 。 
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输入 地 区 区 号 ， 然 后 直接 单 击 “ 确 定 ” 按 钮 ， 进 入 下 一 步 “ 新 建 连接 ”窗口 ， 如 图 6-17 
所 示 。 
位 置信 息 
or 和 和 关于 


目前 所 在 的 国家 /地 区 所); 
[ 


连接 挤 述 


| 


您 的 区 号 喇 城 市 号) 是 什么 C)? 新 尘 活 接 


输入 名 称 并 为 该 连接 选择 图 标 : 
名 称 0 : 


如 果 您 想 指定 一 电话 公司 代码 ， 它 是 什么 @)? 


您 找 外 线 需要 先 找 哪 个 号 码 @)? 


图 标点 ) : 


此 位 置 的 电话 系统 使 用 : 
是 回音 频 拨号 CI) 加 脉冲 拨号 外) 


| CM] 


图 6-16 配置 截图 1 图 6-17 配置 截图 2 
输入 名 称 ， 单 击 “ 确 定 ” 按 钮 进入 下 一 步 ， 如 图 6-18 所 示 。 


选择 连接 串口 ， 这 里 选中 IVT 启动 的 串口 ， 然 后 单 击 “ 确 定 ” 按 钮 ， 进 入 下 一 个 配置 界 
面 ， 如 图 6-19 所 示 。 


/by: 
0) 
sn: 医 Ca 


Himi 


输入 待 找 电 话 的 详细 信息 : 
国家 ( 籽 区 ) C): “| 中 国 (86) 3 


区 号 到 ) : [on ftp: 
电话 呈 码 @): 。 [ 数据 帝 近 制 D): 人 
连接 时 使 用 @@) : ss 
[ER es ETE 
， 图 6-18 配置 截图 3 图 6-19 配置 截图 4 


这 个 界面 中 只 需要 修改 “位 / 秒 ” 选 项 ， 选 中 “115200”， 然 后 单 击 “ 确 定 ” 按 钮 完成 创 
建 ， 此 时 超级 终端 的 界面 如 图 6-20 所 示 。 
当 蓝 牙 端 需要 模拟 发 送 手机 报 文 的 功能 时 ， 其 设置 方法 如 下 : 
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首先 在 “新 建 的 连接 ”界面 的 菜单 中 找到 “文件 一 属性 ”， 然 后 在 出 现 的 窗口 中 ， 选 中 
“设置 ”标签 页 中 的 “ASCII 码 设置 ”按钮 ， 如 图 6-21 所 示 。 


的 于 


6-20 配置 截图 $ 


Himi 屋 性 
连接 到 | 设置 
功能 键 、 箭 头 键 和 Ctrl 键 用 作 
© [uw 同 findows 键 由 ) 


Backspace 键 发 送 
回 ctrlHHC) © Del 0)O ctrlHH Space ,CtrlHHOD 


终端 仿真 到 ) : 

Telnet 终端 ID 中 : ANSI 
反 疮 缓冲 区 行 数 @): 500 

回 连接 或 断 开 时 发 出 声响 企 ) 


[输入 转换 CCD)..，] ASCII 码 设置 @)... 


I 
6-21 配置 截图 6 
然后 在 出 现 的 设置 界面 中 ， 选 中 如 图 6-22 所 示 的 圈 起 的 选项 。 
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AsSCI 码 设置 
ASCII 码 发 诺 
回 以 换行 符 作为 发 送行 未 尾 &) 
同 本 地 回 显 键入 的 字符 E) 
行 卫 RW: 0 毫秒 。 
字符 EiRC): 0 这 种 。 


ASCII 码 接收 

回 将 换行 符 附加 到 传 入 行 示 尾 好 ) 

口 将 传 入 的 数据 转换 为 7 位 的 ASCII 码 包 ) 
回 将 超过 终端 宽度 的 行 自动 换行 外 ) 


书 王 一 


6-22 配置 截图 7 


最 后 一 直 单 击 “确定 ”按钮 即 可 完成 蓝牙 的 设置 。 此 时 可 以 通过 键盘 输入 文字 ， 输 入 的 
字符 默认 会 发 送 给 配对 连接 的 手机 端 。 

蓝牙 开发 的 准备 工作 做 完 之 后 ， 接 下 来 看 一 个 范例 。 新 建 项 目 “BlueToothProject”， 游 
戏 框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代码 为 “6-9( 蓝 牙 对 战 游戏 ) ”。 

这 个 项 目 实 现 一 个 蓝牙 对 战 游戏 。 当 正常 配对 连接 到 IVT (其 他 蓝牙 设备 ) 时 进入 游 
戏 ， 游 戏 中 存在 两 个 填充 圆 形 ， 红 色 圆 形 表示 当前 设备 ， 蓝 色 圆 形 表 示 连 接 的 其 他 蓝牙 设 
备 。 当 前 设备 通过 触 屏 操 控 圆 形 的 移动 ， 而 其 他 设备 是 通过 IVT 软件 模拟 的 蓝牙 终端 ， 所 以 
需要 通过 电脑 键盘 的 “w、s、a、t”4 个 按键 来 操控 。 

由 于 本 项 目 代码 很 长 ， 在 这 里 不 再 详细 讲解 每 行 代码 ， 只 对 重点 的 代码 段 进行 对 应 的 备 
注 。 对 于 游戏 的 绘制 与 组 件 的 添加 等 内 容 ， 在 之 前 的 章节 中 都 详细 讲解 过 ， 这 里 也 不 再 讲 
解 。 

首先 在 AndroidManifest.xml 中 添加 蓝牙 权限 : 


<!-- 声明 蓝牙 权限 --> 
<uses-permission android:name="android.permission.BLUETOOTH" /> 
<!-- 多 许 程序 发 现 和 配对 蓝牙 设备 --> 
<uses-permission android:name="android.permission.BLUETOOTH ADMIN" /> 
在 strings .xml 中 定义 组 件 的 名 字 : 
<string name="openBlueTooth"> 打 开 蓝 牙 </string> 
<string name="blueToothIsVisible"> 蓝 牙 可 见 </string> 
<string name="searchDrives"> 搜 索 设备 </string> 
<string name="connectDrives "> 连接 设备 </ string> 
<string name="choiceConnectDrives"> 请 选择 连接 设备 </ string> 


因为 本 Demo 是 将 游戏 视图 与 组 件 同 时 显示 ， 所 以 修改 Main.xml 布局 文件 : 


<?xml version="1.0" encoding="utf-8"?> 
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<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:orientation="vertical" android:layout width="fill parent" 
android:layout height="fill parent"> 


<RelativeLayout android:layout width="fill Parent" 
android:1layout height="wrap content" 
android:1layout weight="1"> 
<com.himi .MySurfaceView 
android:layout width="fill parent" 
android:layout height="fill parent" /> 
<Button android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:text="@string/openBlueTooth" 
android:id="@+id/Btn OpenBt" /> 
<Button android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout alignParentBottom="true”" 
android:layout toRightOof="@id/Btn OpenBt" 
android:text="@string/blueToothIsVisible" 
android:id="@+id/Btn BtIsVisible" /> 
<Button android:layout width="wrap content™" 
android:layout height="wrap content" 
android:layout alignParentBottom="true”" 
android:layout toRightof="@id/Btn BtIsVisible" 
android:text="@string/searchDrives" 
android:id="@+id/Btn SearchDrives" /> 
<Button android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout alignParentBottom="true” 
android:layout toRightof="@id/Btn SearchDrives" 
android:text="@string/connectDrives" 
android:id="@+id/Btn ConnectDrives" /> 
<TextView android:id="@+id/textview" 
android:layout width="fill parent™" 
android:layout height="fill parent" android:text=" 
谦 节 对 猴 Demo 天 铅 " 
android:textSize="32sp" android:textColor="#000000" 


android:gravity="center horizontal" /> 
</RelativeLayout> 


</LinearLayout> 


此 布局 文件 的 可 视 化 效果 如 图 6-23 所 示 。 
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图 6-23 main.xml 布局 效果 
MainActivity 是 主 Activity 类 ， 其 代码 如 下 : 


public class MainActivity extends Activity implements OnClickListener { 
// 按 钮 组 件 
public static Button btConnect, btOpen, btIsVisible, btSearch; 
// 蓝牙 适配器 
Public static BluetoothAdapter btAda; 
//UUID 协议 
Public static final String SPP UUID = "00001101-0000-1000-8000- 
00805F9B34FB"; 
// 蓝 牙 连接 
public static BluetoothSocket btSocket; 
// 单 利 本 类 
public static MainActivity ma; 
override 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (SavedInstanceState) 
ma = this; 
// 这 里 没有 设置 全 屏 ， 为 了 便于 观察 当前 蓝牙 是 否 打开 的 状态 变化 

//getWindow () .setFlags (WindowManager .LayoutParams . 

FLAG FULLSCREEN, WindowManager.LayoutParams.FLAG FULLSCREEN); 
this.requestWindowFeature (Window. FEATURE NO TITLE); 
setContentView(R.layout.main); 

// 实 例 按钮 

btOpen = (Button) findViewById(R.id.Btn OpenBt); 
btIsVisible = (Button) findViewById(R.id.Btn BtIsVisible); 
btSearch = (Button) findViewById(R.id.Btn SearchDrives); 
btConnect = (Button) findViewById(R.id.Btn ConnectDrives); 
// 为 按钮 绑 定 监听 器 

btOpen.setonClickListener (this); 
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btIsVisible.setOnClickListener (this); 
btSearch. setOnClickListener (this); 
btConnect.setOonClickListener (this); 
// 实 例 蓝牙 适配器 
btAda = BluetoothAdapter .getDefaultAdapter(); 
if (btAda.getstate() == BluetoothAdapter.SsTATE OFF) { 
btopen.setText ("打开 蓝牙 "); 
} else if (btada.getState() == BluetoothAdapter.SsSTATE ON { 
btOpen.setText ("关闭 蓝牙 "); 
} 
// 注册 Receiver 来 获取 蓝牙 设备 相关 的 结果 
IntentFilter intent = new IntentFilter(); 
// 远程 设备 发 现 动作 。 
intent .addAction (BluetoothDevice.ACTION FOUND); 
// 远 程 设备 的 键 态 的 变化 动作 。 
intent .addAction (BluetoothDevice.ACTION BOND STATE CHANGED); 
// 蓝牙 扫描 本 地 适配器 模 改 变动 作 。 
intent .addAction (BluetoothAdapter .ACTION SCAN MODE CHANGED) ; 
// 状 态 改变 动作 
intent .addRction (BluetoothAdapter .ACTION STATE CHANGED) 
registerReceiver (searchDevices，intent) ;// 注 册 接 收 
// 监 听 动 作 
Private BroadcastReceiver searchDevices = new BroadcastReceiver() { 
Public void onReceive (Context context, Intent intent) { 
String action = intent.getAction(); 
// 搜 索 设 备 时 ， 取 得 设备 的 MAC 地 址 
if (BluetoothDevice.ACTION FOUND.equals (action)) { 
BluetoothDevice device = intent. 
getParcelableExtra (BluetoothDevice.EXTRA DEVICE); 
String str = "设备 : " + device.getName() + "*" 十 
device.getAddress (); 
if (MySurfaceView.vc str != null) { 
if (MySurfaceView.vc str.size() != 0) { 
for (int j = 0; j<MySurfaceView. 
VOTStre Slize( tt 
// 防止 重复 添加 
if (MySurfaceView.vc str. 
elementAt (j) .equals (str) 
= false) { 
// 容器 添加 发 现 的 设备 名 称 和 mac 地 址 
MySurfaceView.vc str. 
addElement (str); 


} else { 
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MySurfaceView.vc str.addElement (str); 
} 


}; 


@Override 
protected void onDestroy() { 
this.unregisterReceiver (searchDevices); 
super.onDestroy (); 
System.exit (0); 
Q@Override 
public void onClick(View v) { 
if (MySurfaceView.gameState != MySurfaceView.CONNTCTED) { 
if (v == btOpen) {// 蓝 牙 开 关 
if (btAda.getState() == BluetoothAdapter. 
STATE OFF) { 
btAda.enable (); 
btOpen. setText ("关闭 蓝牙 "); 
} else if (btada.getState() == BluetoothAdapter. 
STATE ON) { 
btAda.disable(); 
btOpen. setText ("打开 蓝牙 "); 
} 
} else if (v == btIsVisible) {// 蓝 牙 是 否 可 见 
Intent intent = new Intent (BluetoothAdapter. 
ACTION REQUEST DISCOVERABLE); 
intent .putExtra (BluetoothAdapter.EXTRA DISCOVERABLE DURATION, 
110); 
// 第 二 个 参数 是 本 机 蓝牙 被 发 现 的 时 间 ， 系 统 默 认 范 围 [1-300]， 
// 超 过 范围 默认 300， 小 于 范围 默认 120 
startActivity (intent); 
} else if (v == btSearch) {// 搜 索 蓝牙 
// 如 果 蓝 牙 还 没 打开 
if (btada.getState() == BluetoothAdapter. 
STATE OFF) {Toast .makeText (MainActivity.this, 
"请 先 打开 蓝牙 "，1000) .show () ; 
return; 


} 
setTitle ("本 机 蓝牙 地 址 : " + btaAda.getAddress()); 


MySurfaceView.vc str.removeAllElements(); 
btAda.startDiscovery(); 

} else if (v == btConnect) { 
if (MySurfaceView.vc str.size() 一 0) { 
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Toast.makeText(MainRctivity.this，" 当 前 没有 设备 "， 
1000) .show () 

} else { 
Intent intent = new Intent(); 
// 打 开 显示 搜索 的 蓝牙 设备 的 Activity 
intent.setClass (this,ChoiceDrivesList .class); 
this.startActivity (intent); 


} 
} else { 
Toast.makeText (this,， "这 里 只 是 一 个 Demo 示例， 很 多 情况 没有 进行 处 
理 ， 为 了 等 出 现 误 操作 造成 异常 ， 请 重新 运行 项 目 ! "，Toast. 
LENGTH LONG) .show(); 
this.finish(); 


ChoiceDrivesList 类 用 于 显示 搜索 到 的 所 有 蓝牙 设备 。 


public class ChoiceDrivesList extends Activity { 
// 所 有 蓝牙 设备 的 名 字 
Private String[] names; 
// 提 示 
Private Toast toast; 
// 对 话 框 显示 当前 搜索 到 的 蓝牙 设备 
Private AlertDialog.Builder dialog; 


public ChoiceDrivesList() { 
names = new String[MySurfaceView.vc str.size()]; 
for (int i = 0; i < MySurfaceView.vc str.size(); i++) { 
names[i] = MySurfaceView.vc str.elementAt (i); 
遇 
上 
Public void DisplayToast (String str, int type) { 
try { 
toast = null; 
if (type == 0) { 
toast = Toast.makeText (this, str, 
Toast.LENGTH SHORT); 
} else { 
toast = Toast.makeText (this, str, 
Toast. LENGTH LONG); 
toast.setGravity (Gravity.TOP, 0, 220); 
toast.show(); 
} catch (Exception e) { 
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// TODO: handle exception 


@Override 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
dialog = new AlertDialog.Builder (ChoiceDrivesList.this); 
dialog.setIcon(android.R.drawable.btn dialog); 
dialog.setSingleChoiceItems (names, 0, new DialogInterface. 
OnClickListener() { 
Public void onClick (DialogInterface dialog, int which) { 
MySurfaceView.deviceIndex = which; 


1 
}) .setIcon (R.drawable.icon) .setPositiveButton ("连接 ",，new 


DialogInterface.OnClickListener() { 
public void onClick (DialogInterface dialoginterface, int i) { 
DisplayToast ("正在 连接 设备 : " + 
MySurfaceView.vc str.elementAt (MySurfaceView. 
deviceIndex), 1); 
MySurfaceView. gameState = MySurfaceView .CONNTCTING; 
new ConnectThread () .start (); 
finish(); 
}) .setNegativeButton ("取消 "，new DialogInterface. 
OnClickListener () { 
public void onClick(DialogInterface dialoginterface，int i) { 
finish() 


由 
}) .setTitle (" 请 选择 连接 设备 !") ; 
dialog.show() 7 


由 于 本 类 是 一 个 Activity 活动 ， 所 以 在 AndroidManifestxml 文件 中 需要 声明 以 下 内 容 : 


<activity android:name=".ChoiceDrivesList" 
android:label="@string/choiceConnectDrives" 
android:configChanges="orientation| keyboardHidden™" 
android:screenOrientation="portrait" 
android:theme="@android:style/Theme.Dialog"> 
</activity> 


ConnectThread 类 的 主要 作用 是 ， 当 成 功 连接 其 他 蓝牙 设备 后 ， 线 程 不 断 接 受 报 文 数据 ， 
其 代码 如 下 : 


public class ConnectThread extends Thread { 
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Private BlueToothServer bts; 
@Override 
public void run() { 
// 取 消 可 见 
MainActivity.btAda.cancelDiscovery(); 
String str = 
MySurfaceView.vc str.elementAt (MySurfaceView.deviceIndex); 
// 这 里 split 的 参数 是 采用 正则 表达 式 规则 
String[] values = str.split("\\*"); 
//split 此 方法 把 字符 串 分 割 成 多 个 字符 串 , 这 里 分 成 两 个 字符 串 
A 7) 修 
String address = values[1];// 这 里 就 是 取出 连接 设备 的 mac 地 址 
//Android 蓝牙 普遍 支持 SPP 协议 
UUID uuid = UUID.fromStrin9g(MainRctivity.SPP UUID); 
// 实 例 蓝牙 设备 
BluetoothDevice btDevice = MainActivity.btAda. 
getRemoteDevice (address); 
try { 
MainActivity.btSocket = btDevice. 
createRfcommSocketToServiceRecord (uuid); 
MainActivity.btSocket.connect (); 
} catch (IOException e) { 
Log.e("Himi", "Connected Error!"); 
Toast.makeText (MainActivity.ma, "无 法 连接 此 设备 !"， 
1000) .show (); 
e.printstackTrace(); 
return; 


} 

// 当 正常 连接 配对 其 他 蓝牙 设备 后 启动 线程 ， 一 直 监听 报 文 数据 
MySurfaceView.gameState = MySurfaceView.CONNTCTED; 
bts = new BlueToothServer(); 

bts.flag = true; 

bts.start (); 


} 
class BlueToothServer extends Thread { 

Private InputStream ips; 

boolean flag; 

@Override 

public void run() { 

while (flag) { 
if (MySurfaceView.gameState == MySurfaceView .CONNTCTED) 


try { 
// 没 有 接收 到 数据 ， 这 里 一 直 处 于 阻塞 状态 


ips = MainActivity.btSocket. 
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getIinputStream(); 
byte[] buffer = new byte[1024]; 
if (ips.read (buffer) != -1) { 
String str=new String(buffer, 0, 1); 
if (str.equals("w")) {// 上 
MySurfaceView.other Arcy -= 5; 
} else if (str.equals("s")) {// 下 
MySurfaceView.other Arcy += 5; 
} else if (str.equals("a")) {// 左 
MySurfaceView.other Arcx -= 5; 
} else if (str.equals ("d")) {// 右 
MySurfaceView.other Arcx += 5; 


} 

} catch (IOException e) { 
Log.e("Himi", "inPputStream is Error!!"); 
e.printStackTrace (); 


最 后 是 整个 游戏 视图 MySurfaceView 类 : 


Public class MySurfaceView extends SurfaceView implements Callback, 
Runnable { 

Private Thread th; 

Private SurfaceHolder sfh; 

Private Canvas canvas; 

Private Paint paint; 

Private boolean flag; 

// 用 于 存储 搜索 到 的 蓝牙 设备 

public static Vector<String> ve str; 

// 未 连接 蓝牙 设备 

Public static final int NONE = 1; 

// 正 在 连接 蓝牙 设备 

public static final int CONNTCTING = 2; 

// 已 连接 蓝牙 设备 

Ppublic static final int CONNTCTED = 3; 

// 当 前 蓝牙 连接 状态 

public static int gameState = NONE; 

// 连 接 蓝 牙 设备 的 下 标 索引 

public static int deviceIndex; 

Public static int myArc x = 50, myArc y = 150, other Arcx = 110, 
other Arcy = 150; 

private OutputStream ops; 
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public MySurfaceView (Context context, AttributeSet attrs) { 
super (context, attrs); 
vc str = new Vector<String>(); 
this .setKeepScreenOn (true); 
sfh = this.getHolder (); 
sfh.addCallback (this); 
paint = new Paint(); 
paint.setAntiAlias (true); 
this.setLongClickable (true); 
this.setFocusable (true); 
this.setFocusableInTouchMode (true); 
Log.e("Himi", "surfaceChanged"); 
} 
Public void surfaceCreated(SurfaceHolder holder) { 
flag = true; 
th = new Thread (this, "himi Thread one"); 
th.start (); 
Log.e("Himi", "surfaceCreated"); 
Public void surfaceChanged(SurfaceHolder holder, int format, int 
width, int height) { 
Log.e("Himi", "surfaceChanged"); 
| 
Public void surfaceDestroyed(SurfaceHolder holder) { 
flag = false; 
Log.e("Himi", "surfaceDestroyed"); 
Public void myDraw() { 
try { 
canvas = sfh.lockCanvas (); 
if (canvas != null) { 
canvas.drawColor (Color .WHITE); 
paint.setColor (Color .RED); 
switch (gameState) { 
case NONE: 
Af (ve str Y= D011) { 
for (int i=0;i<ve str.size();i++){ 
paint.setTextSize (12); 
canvas.drawText (VC_Str.elementRt (i), 3, 150 + 
二 307 parnt)s 
} 
} 
break; 
Case CONNTCTING: 
paint.setTextSize(20); 
canvas.drawText ("正在 连接 设备 :"，3，150,，paint); 
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paint.setTextSize (12); 
canvas.drawText (vc_ str.elementAt (deviceIndex),3, 
190, paint); 

break; 

Case CONNTCTED: 
paint.setTextSize (20); 
paint.setTextSize(12); 
canvas .drawText ("已 成 功 连接 :" + 
ve_str.elementAt (deviceIndex), 10, 110, 

paint); 
Paint.setColor (Color .RED); 
canvas .drawCircle (myArc x, myArc y, 20, 
paint); 
paint.setColor (Color .BLUE); 
canvas .drawCircle (other Arcx, other Arcy, 
20, paint); 
Paint.setColor (Color .BLACRK); 
canvas .drawText ("我 方圆 形 "， myArc x - 20, 
myArc y ~ 25, paint); 
canvas .drawText ("对 方圆 形 "， other Arcx - 20, 
other Arcy - 25, paint); 

break; 


} 
} catch (Exception e) { 
Log.v("Himi", "draw is Error!"); 
e.printstackTrace(); 
} finally { 
if (canvas != null) 
sfh.unlockCanvasAndPost (canvas); 


a. 

@Override 

Pub1lic boolean onKeyDown (int keyCode, KeyEvent event) { 
return true; 

2 

@Override 

Public boolean onTouchEvent (MotionEvent event) { 
if (gameState == CONNTCTED) { 


try { 
ops = MainActivity.btSocket.getOutputstream(); 
byte bx[] = null; 
byte by[] = null; 
myArc x = (int) event.getx(); 


myarc y = (int) event .getY (); 
bx = new String("X=" + myArc x) .getBytes(); 
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by = new String("X=" + myArc x) .getBytes(); 
if (bx != null && by != null) { 
ops.write (bx); 
ops.write (by) ; 
} 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace (); 


} 
return true; 
} 
Private void logic() { 
} 
Public void run() { 
while (flag) { 
logic(); 
myDraw (); 
try { 
Thread. sleep (100); 
} catch (Exception ex) { 
} 


项 目 运 行 效果 如 图 6-24 所 示 。 


本 请 选择 连接 设备 ! 


设 
备 : HimiPC*00:19:86... 


关闭 莽 牙 ”到 牙 可 见 提亲 设备 爱 搜 设 做 关闭 基 牙 天 牙 可 见 搜索 设备 连接 讽 备 


图 6-24 项 目 效果 图 
当 IVT 模 拟 蓝牙 终端 发 送 报 文 数据 时 ， 其 界面 如 图 6-25 所 示 。 
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Ce 省 | 国 20:11 的 当 串 国 20:12 


三 Himi - 超级 终 详 
文件 (F) ”编辑 (E) 查看 (V) ”呼叫 ( 〇 传送 (]) 帮助 (H) 
DD 世人 二 5 六 疡 


SSSSSSSSSSSSSS_ 


关闭 蓝牙 。 蓝牙 可 见 ”搜索 设备 连接 设备 。 “关闭 蓝牙 。 蓝牙 可 见 ”搜索 设备 连接 设备 


图 6-25 IVT 终端 控制 圆 形 移动 


当前 设备 发 送 给 IVT 蓝牙 终端 报 文 数据 时 ， 其 界面 如 图 6-26 所 示 。 
当前 设备 操控 红色 圆 形 移动 ， 也 会 将 圆 形 的 坐标 发 送 给 配对 的 蓝牙 设备 ， 这 里 是 发 给 
IVT 模拟 的 蓝牙 终端 。 
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Ee 避 自命 20:12 和 迷 明生 全 20:13 


蓝牙 对 战 Demo 示 例 《蓝牙 对 战 Demo 示 例 


:设备 ; HimipC*00:19.86:00.28:48 成 功 连接 :设备 : HimiPC*00:19:86:00:28:48 


我 方 加 形 


对 方 固形 对 方 图 形 


我 方 四 形 


关闭 蓝牙 。 蓝牙 可 见 设备 。 连接 设备 。 “关闭 蓝牙 。 蓝牙 可 见 ”搜索 设备 连接 设备 


司 Himi - 起 @ 终 儿 (=19 
文件 中 ” 坊 坟 个 ”去 看 WW 时 叫 (O 传送 四 帮助 员 ) 

[证 
=147X=147X=147X=147X=147X=147X=147X=147X=147X=147X= ~ 
=147K=147X=147X=147X=147X=147X=147X=147X=147K=147YX= 
=148X=148X=148X=148X=148X=148X=148X=148X=148X=148X= 
180X=181X=181X=181X=181X=182X=182X=182X=182X=182X= 
=185X=185X=186X=186X=187X=187X=187X= 
on ool oo leo a 
= 90X=190X=190X=190X=190X=190X= EE 
190Y= 190%= 190%= 189Y= 139% 189X= 区 189X=189_ 如 


连接 2:20:27 自动 检测 。 115200 8-N-1 


图 6-26 当前 设备 控制 圆 形 移动 


网 络 游戏 开发 基础 


在 手机 网 游 开 发 中 ， 客 户 端 与 服务 端的 通信 方式 经 常 使 用 两 种 协议 ， 一 种 是 Socket 协 
议 ， 另 外 一 种 是 Http 协议 。 两 种 协议 最 主要 的 区 别 在 于 : 

Socket 协议 属于 长 连接 ， 一 旦 客户 端正 常 连接 到 服务 器 端 ， 如 果 两 端 没有 单纯 的 断 开 操 
作 ， 那 么 下 次 交互 数据 就 不 需要 再 次 连接 ， 两 者 将 一 直 维持 交互 状态 。 这 种 交互 协议 适用 于 
即时 通信 类 型 的 游戏 ， 例 如 ARPG、RPG 等 。 
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Http 协议 属于 短 连 接 ， 当 客户 端正 常 连 接 到 服务 端 后 ， 一 旦 数据 交互 完 后 就 会 断 开 ， 不 
会 像 Socket 那样 维持 连接 状态 。 
对 于 这 两 种 通信 协议 ， 这 里 也 是 简单 地 描述 了 一 下 ， 详 细 的 说 明 可 以 参阅 其 他 书籍 和 资料 。 


本 小 节 服 务 端 是 由 Java 项 目 实现 的 。 


6.10.1 Socket 
通信 数据 都 是 以 流 进行 读 写 ， 那 么 应 该 优先 考虑 如 何 得 到 输入 输出 流 。 


InputStream is = Socket.getInputStream(); 
OutputStream os =Socket.getOutputStream(); 


客户 端 与 服务 器 获取 输入 输出 流 的 方法 都 是 通过 Socket 实例 来 实现 ， 然 后 进行 通信 ， 最 
后 对 数据 进行 读 写 操作 。 

Socket 类 客户 端的 构造 方法 : 
Socket socket = Socket (String dstName, int dstPort); 

e 第 一 个 参数 : 服务 器 地 址 ; 

日 第 二 个 参数 : 服务 器 端口 。 

Socket 类 服务 端的 构造 方法 : 
Socket socket = ServerSocket .accept () ; 

其 作用 是 监听 是 否 有 客户 端 连接 ， 当 客户 端正 常 连接 后 会 返回 一 个 Socket 实例 。 
ServerSocket 类 是 通过 端口 实例 化 的 。 


下 面 简单 完成 客户 端 (Android 项 目 ) 发 送 给 服务 端 (Java 项 目 ) 一 字符 串 ， 然 后 服务 
器 接受 并 返回 此 字符 串 给 客户 端 。 本 小 节 对 应 源 代码 为 “6-10-1 (Socket 协议 ) ”。 


1 . 创建 服务 端 
新 建 Java 项目 “MySocketServer”， 新 建 类 MyServer， 其 代码 如 下 : 


public class MyServer { 
// 服 务 器 连接 
public static ServerSocket serverSocket; 
// 连 接 
public static Socket socket; 
// 端 口 
public static final int PORT = 8888; 
public static void main(String[] args) { 
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DataInputStream dis = null; 
DataOutputStream dos = null; 
try { 
ServerSocket = new ServerSocket (PORT); 
System. out .println ("正在 等 待 客户 端 连 接 . . ."); 
// 这 里 处 于 等 待 状态 ， 如 果 没 有 客户 端 连接 ， 程 序 不 会 向 下 执行 
Socket = serverSocket.accept (); 
dis = new DataInputStream(socket.getIinputStream()); 
dos = new DataOutputStream(socket.getOutputStream()); 
// 读 取 数据 
String clientStr = dis.readUTF(); 
// 写 出 数据 
dos.writeUTF (clientstr); 
System.out.println("---- 客 户 端 已 成 功 连接 !----") ; 
// 得 到 客户 端的 IP 
System.out.println(" 客 户 端的 IP =" + 
Socket.getInetRddress () ) ; 
// 得 到 客户 端的 端口 号 
System.out.println ("客户 端的 端口 号 =" + socket.getPort () ) ; 
// 得 到 本 地 端口 号 
System.out.println ("本 地 服务 器 端口 号 ="” + 
socket.getLocalPort ()); 
System. out .println("----------------------- jo 
System.out.println ("客户 端 : " + clientStr) ; 
} catch (IOException e) { 
e.printstackTrace(); 
} finally { try 
if (dis != null) 
dis.close(); 
if (dos != null) 
dos.close(); 
} catch (IOException e) { 
e.printStackTrace (); 


; 


代码 很 简单 ， 服 务 端 主要 是 监听 端口 ， 一 旦 客户 端 连接 上 ， 就 先 读 取 数据 ， 然 后 再 写 给 
2 实现 客户 端 


新 建 项 目 “SocketClient”， 创 建 主 Activity 类 MainActivity。 因 为 通信 需要 权限 ， 所 以 
需要 在 AndroidManifest.xml 文件 中 声明 联网 权限 : 
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<uses-permission android:name="android.permission.INTERNET" /> 


然后 简单 写 一 个 布局 ， 添 加 一 个 “发 送 ” 按 钮 、 文 本 编辑 组 件 等 。 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android™" 


android:orientation="vertical" android:layout width="fill parent" 
android:layout height="fill parent"> 

<TextView android:layout width="fill parent™" 

android:layout height="wrap content" android:text="@string/hello" /> 


<EditText android:id="@+tid/edit" 


android:layout width="fill parent" 
android:layout height="wrap content" /> 


<Button android:id="@+id/Btn commit™ 


android:layout width="wrap content" 
android:layout height="wrap content" android:text="@string/send" /> 


<TextView android:layout width="fill parent" android:id="@+id/tv" 


android:layout height="wrap content" android:text="@string/get" /> 


</LinearLayout> 


<string nam 
<string name 


布局 效果 如 图 6-27 所 示 。 


在 


图 6-27 布局 示意 图 


E strings.xml 文件 中 添加 3 个 字符 串 : 


"hel10o"> 这 里 输入 文字 发 给 服务 器 </string> 
rsend"> 发 送 </string> 


<string name="get "> 这 里 显示 服务 器 发 来 的 信息 !</string> 
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最 后 修改 MainActivity 主 活动 类 ， 代 码 如 下 : 


public class MainActivity extends Activity implements OnClickListener { 
Private Button btn ok; 
Private EditText edit; 
private TextView tv; 
//Socket 用 于 连接 服务 器 获取 输入 输出 流 


Private Socket socket; 


// 服 务 器 server/IP 地 址 

Private final String ADDRESS = "192.168.1.100"; 
// 服 务 器 端口 

Private final int PORT = 8888; 

QOverride 


Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


this.getWindow () .setFlags (WindowManager.LayoutParams .FLAG FULLSCR 
EEN, WindowManager.LayoutParams.FLAG FULLSCREEN); 
this.requestWindowFeature (Window. FEATURE NO_ TITLE); 
setContentView(R.layout.main); 
btn ok = (Button) findViewById(R.id.Btn commit); 
tv = (TextView) findViewById(R.id.tv); 
ed 让 = (EditText) findViewById(R.id.edit); 
btn ok.setonClickListener (this); 
}: 
Public void onClick(View v) { 
if (v == btn ok) { 
DataInputStream dis = null; 
DataOutputStream dos = null; 
try { 
/ /阻塞 函数 ， 正 常 连接 后 才 会 向 下 继续 执行 
socket = new Socket (ADDRESS, PORT); 
dis = new DataInputStream(socket. 
getInputStream() ) ; 
dos = new DataOutputStream (socket. 
getOutputStream()); 
// 向 服务 器 写 数据 
dos.writeUTF (edit .getText() .上 toString() ) 
String temp = "I say:"; 
temp += edit.getText().toString(); 
temp += "\n"; 
temp += "Server say:"; 
// 读 取 服务 器 发 来 的 数据 
temp += dis.readUTF (); 
tv.setText (temp); 
} catch (IOException e) { 
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Log.e("Himi", "Stream error!"); 
e.printStackTrace (); 
} finally { 
try { 
if (dis != null) 
dis.close(); 
if (dos != null) 
dos.close(); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace (); 


这 里 要 提醒 的 一 点 ， 因为 服务 端 是 先 获取 客户 端 发 来 的 数据 ， 然 后 再 写 给 客户 端 ， 所 以 
客户 端 应 该 是 先 写 给 服务 端 数据 ， 然 后 再 读 取 服务 端 发 来 的 数据 ， 如 图 6-28 所 示 。 


阳 塞 函数 ,正常 连接 后 才 会 向 下 继续 执行 
Socket = new Socket (ADDRESS, PORT); 


ServerSocket = new ServerSocket (PORT); 


Syscem.out.princln(" 正 在 等 待 客户 端 连接 . . . 


// 这 里 处 于 等 待 状态 ， 如 果 没 有 客户 端 连接 ， 程 
Socket = serverSocket.accept (); 
dig = new DataInputStream(socket.getIinpu 


dis = new DatalInputStream(socket .getInpr 
dos = new DataOutputSstream(socket .getOu 


向 服务 器 瑟 数 据 


dos.writeUTF (edit.getText () ,toString ()) 


dos = new DataOutputStream(socket. getOut 
/ 读 取 数据 String temp = "I say:"; 


String clientStr =|dis.readUTF(); temp += edit.getText() .toString(); 
/ 写 出 数据 


temp += "\n"; 
[dos .writeUTF (clientStr); 


System. our.printin("---- 宪 了 法 取 了 服务 

// 得 到 客户 端的 Te 5 temp += dis.readUTF(); 
System.out.printin ("客户 端的 IP =" + sockd 61 tv. setrext (temp); 

// 得 到 客户 端的 端口 号 6 } catch (IOException e) { 
System.out.printin ("客户 端的 端口 号 =" + sd 63 Log.e("Himi", "Stream error!"); 
/得 到 本 地 端口 号 6 e.printStackTrace (); 
System.out.printin ("本 地 服务 器 端口 号 =" + 65 } finally { 

System. out.printlin("-— ~ 66 try { 

System.out.println(" 客 : "+ clientSt if (dis != nall) 


dis.close(); 


toh (IOException e) { 


~ i Fine t= mn 


6-28 ” 写 入 读 取 顺序 对 比 
首先 运行 服务 器 端 ， 运 行 效果 如 图 6-29 所 示 。 


是 console 3B、 
MyServer Dava Application] D:VavaVire6\binViavaw ex 


正在 等 待 客户 端 连 接 . . . 


图 6-29 ”启动 服务 端 
然后 运行 客户 端 ， 并 点 击发 送 数 据 ， 如 图 6-30 所 示 。 
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EB Console 
<terminated> MyServer [Java Application] D:;Java\jr 
正在 等 待 客户 端 连接 . . . 

---- 客 户 端 已 成 功 连接 :--- 


图 6-30 Client 与 Server 通 信 


此 实例 只 是 简单 实现 客户 端 与 服务 端的 一 次 性 通信 。 其 实 服务 端 监听 端口 事件 应 该 放 在 
线程 中 不 断 地 去 监听 是 否 有 客户 端 连接 毕 况 网 游 中 不 只 一 个 客户 端 ， 然 后 为 每 个 客户 端 
分 配 一 个 线程 去 处 理 读 写 数据 事件 。 本 小 节 只 是 让 读者 了 解 和 熟悉 客户 端 与 服务 端 是 如 何 连 
接 与 通信 的 ， 由 于 网 游 服 务 与 客户 端的 细节 处 理 过 多 ， 这 里 就 不 再 详 述 ， 更 详细 的 交互 与 细 
节 处 理 可 以 参阅 其 他 书籍 和 资料 。 


6.10.2 ”Http 
利用 Http 通讯 同样 需要 分 为 服务 端 与 客户 端 。 由 于 服务 端 需要 使 用 Java 项 目 实现 ， 牵 扯 到 

J2EE 的 知识 ， 所 以 这 里 就 不 再 利用 Java 实现 服务 端 ， 而 是 简单 地 使 用 百度 网 站 作为 服务 端 。 
首先 优先 考虑 如 何 得 到 输入 输出 流 : 


URLConnection urlConnect = URL.openConnection() 


URLConnection 类 通过 地 址 URL 连接 服务 器 ， 并 获取 连接 实例 URLConnection， 然 后 通 
过 URLConnection 类 获取 输入 输出 流 ， 用 于 读 取 和 写 入 数据 操作 : 
// 获 取 输 入 流 
DataInputStream dis = new DataInputStream 


(urlConnect.getInputstream()); 


// 获 取 输 出 流 


313 


An 


d 游 戏 编程 之 从 零 开始 


DataOutputStream dos = new DataOutputStream(urlConnect.getOutputStream()); 


接 下 来 通过 Http 协议 访问 “百度 ”获取 数据 的 示例 ， 来 熟悉 Android 客户 端 是 如 何 连 接 
到 服务 端 ， 并 且 获 取 输 入 输出 流 对 数据 进行 操作 的 。 

新 建 项 目 “MyHttpClient”， 主 Activity 类 为 MainActivity， 项 目 对 应 的 源 代码 为 “6-10- 
2 〈Http 协议 ) ”。 首 先 在 AndroidManifestxml 中 添加 联网 权限 : 


<uses-permission android:name="android.permission.INTERNET" /> 


然后 修改 main.xml 布局 ， 添 加 一 个 按钮 和 文本 组 件 : 


<?xml version="1.0" encoding="utf-8"?> 
<ScrollView xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" android:layout width="fill parent" 
android:layout height="fill parent"> 
<LinearLayout android:orientation="vertical”" 
android:layout width="fill parent" 
android:layout height="fill parent"> 
<Button android:id="@+tid/Btn commit™" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text=" 肆 能 股 多 竹 "” /> 
<TextView android:layout width="fill parent" 
android:id="@+tid/tv" 
android:layout height="wrap content" 
android:text=" 饭 示 尖 折 到 让 务 父 入 筷 ”/> 
</LinearLayout> 
</ScrollView> 


由 于 获取 的 数据 可 能 在 屏幕 中 无 法 完整 显示 ， 所 以 整个 布局 使 用 了 ScrollView 滚动 显 
示 。 布 局 如 图 6-31 所 示 。 


图 6-31 布局 示意 图 
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public class MainActivity extends Activity implements OnClickListener { 
Private Button btn ok; 
Private TextView tv; 
Private final String ADDRESS = "http://www.baidu.com"; 
// 声 明 http 连接 
Private URLConnection urlConnect; 
// 声 明 服务 器 地 址 
Private URL url; 
Q@Override 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 


this.getWindow() .setFlags (WindowManager.LayoutParams. FLAG FULLSCR 
EEN, WindowManager.LayoutParams.FLAG FULLSCREEN); 
this.requestWindowFeature (Window. FEATURE NO TITLE); 
setContentView(R.layout.main); 
btn ok = (Button) findViewById(R.id.Btn commit); 
tv = (TextView) findViewById(R.id.tv); 
btn ok.setOonClickListener (this); 
} 
Public void onClick(View v) { 
DataInputStream dis = null; 
if (v == btn ok) { 
try 
// 实 例 地 址 
url = new URL (ADDRESS); 
// 实 例 Http 连接 
urlConnect = url.openConnection(); 
// 获 取 输 入 流 
dis = new DataInputStream(urlConnect. 
getInputStream()); 
// 获 取 输出 流 
/VData0utputStream dos = new DataOutputStream 
(urlConnect.getOutputstream()); 
// 获 取 服 务 器 返回 的 数据 
int temp = 0; 
ByteArrayBuffer baff = new ByteArrayBuffer(1000); 
while ((temp = dis.read()) != -1) { 
baff .append (temp); 


} 
// 将 服务 器 返回 的 信息 显示 在 文本 


tv.setText (EncodingUtils.getString (baff.toByteArray (), 
"UFT-8") ); 
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} catch (MalformedURLException e) { 
// TODO Auto-generated catch block 
e.printstackTrace(); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace (); 
} finally { 
try { 
dat (dis d= maully 
dis.close(); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace (); 


项 目 运 行 效果 如 图 6-32 所 示 。 
其 实在 Android 中 ，Http 访问 服务 器 的 方式 很 多 ， 例 如 也 可 以 利 HttpURLConnection 来 
实现 连接 Http 协议 访问 服务 端 。 


连接 服务 器 


显示 获取 到 的 服 do tml><html><head http- 
html; 
OlONOEOOOOUOO 
x arlal'text-allgn 


orm,#fm{po: 
rder:0}at{ 


图 6-32 Http 访问 服务 器 
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本 地 化 与 国际 化 


- 款 游戏 或 者 一 个 应 用 开发 完成 后 ， 可 能 会 放 到 国外 的 平台 渠道 ， 不 同 地 区 使 用 的 语言 
是 不 相同 的 ， 比 如 中 国 大 陆 使 用 简体 中 文 ， 台 湾 地 区 使 用 繁体 中 文 等 。 那 么 一 款 简体 中 文 的 
Android 应 用 ， 如 果 投 放 在 国外 或 者 中 国 台湾 地 区 是 不 是 要 重新 蔡 换 所 有 字符 ， 重 新 打包 
呢 ? 答案 是 否定 的 。 
其 实 做 法 很 简单 ， 在 之 前 的 章节 介绍 Android 目录 结构 时 ， 曾 经 提 到 过 在 res 目录 下 的 
drawable 目录 ， 从 SDK 1.6 以 后 就 变 成 了 drawble-hdpi、drawable-ldpi、drawable-mdpi 3 个 目 
录 ， 其 作用 是 Android 在 运行 程序 时 ， 会 根据 当前 设备 信息 选择 对 应 的 资源 文件 夹 。 而 
Android 项 目 资源 文件 res 目录 下 的 values 目录 ， 在 运行 应 用 时 ， 会 根据 当前 不 同 的 手机 设备 
语言 选择 不 同 的 values 路 径 ; 当然 values 的 其 他 语言 的 版 本 ，ADT 并 没有 自动 生成 ， 需 要 自 
定义 文件 目录 。 

下 面 通过 实例 来 详细 讲解 这 个 多 语言 功能 的 实现 方法 。 新 建 项 目 “LocalProject”， 游 戏 
框架 为 SurfaceView 游戏 框架 ， 项 目 对 应 的 源 代码 为 “6-11 〈 本 地 化 与 国际 化 ) ”。 
首先 在 string.xml 中 添加 一 个 字符 串 : 


<string name="localTest">LocalTest</string> 


修改 MySurfaceView 类 的 绘图 函数 ， 绘 制 出 新 添加 的 字符 串 : 


Public void myDraw() { 


canvas.drawText (this.getResources() .getString (R.string. 
localTest), 40, 40, paint); 


运行 项 目 ， 效 果 如 图 6-33 所 示 。 


LocalTest 


图 6-33 效果 图 1 
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下 面 在 res 目录 下 添加 3 个 新 的 values 目录 ，values-en-rUS、values-zh-rCN 和 values-zh- 
ITW， 如 图 6-34 所 示 。 


4 EE values 
g name="localTest">LocalTest</string> 


用 strings.xml 


4 EE values-en-rUS 


| strings.xml 4 name="loca st">(English) :LocalTest</str 


4 EE values-zh-rCN 


因 stringsxml | <3tring name="localTest"> (中 文 简体 语言 ) :LocalTest</string> 


4 BE values-zh-rTW 
X strings.xml <string name="1localTest"> (中 文 葡 体 语言 ) :LocalTest</string> 


图 6-34 values 不 同 语言 版 本 


目录 的 命名 格式 为 “values- 语 言 缩写 -r 国家 地 区 简写 ”， 比 如 : 


@ values-en-rUS :对 应 设备 语言 是 英文 ; 
e values-zh-rCN: 对 应 设备 语言 是 中 文 简体 ; 
@ values-zh-rTW: 对 应 设备 语言 是 中 文 繁 体 。 


为 了 更 好 地 看 出 区 别 与 效果 ， 每 个 不 同 语言 版 本 的 values 中 定义 的 localTest 值 ， 都 设置 
不 一 样 的 字符 串 。 设 置 模拟 器 或 者 设备 的 语言 为 英文 ， 并 且 重 新 运行 项 目 ， 效 果 如 图 6-35 所 


示 。 


岛 面 夯 1:14 pM 


English (Canada) 
English (New Zealand) 


English (Singapore) 


English (United Kingdom) 


English (United States) 


Espaiiol 


图 6-35 英文 版 项 目 截图 


设置 模拟 器 或 者 设备 的 语言 为 中 文 简体 ， 并 且 重新 运行 项 目 ， 效 果 如 图 6-36 所 示 。 

设置 模拟 器 或 者 设备 的 语言 为 中 文 繁体 ， 并 且 重 新 运行 项 目 ， 效 果 如 图 6-37 所 示 。 

当 设 备 的 语言 在 项 目 中 找 不 到 对 应 语言 版 本 的 values 目录 时 ， 默 认 使 用 values 路 径 。 设 
置 模拟 器 或 者 设备 的 语言 为 法 语 ， 并 且 重 新 运行 项 目 ， 效 果 如 图 6-38 所 示 。 
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crv] 


Negerlangs (Belgle) 
Nederlands (Nederland) 
Polski 


Pyccxkni 


中 中 文 (简体 ) 
图 6-36 中文 简体 版 项 目 截图 
岛 而 夯 下 寺 120 
Nederlangs (belgie) 
Nederlands (Nederland) 
Polski 
Pycckni 


| 


中 文 (简体 ) 


图 6-37 中 文 繁体 版 项 目 截图 


Frangais (Belgique) 
Frangais (Canada) 
Frangais (France) 
Frangais (Suisse) 
ltaliano (Italia) 


Ttaliano (Svizzera) 


6-38 ”法 语 版 本 项 目 截图 


| 
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当然 ， 有 时 需要 强制 使 用 一 种 语言 版 本 ， 可 以 通过 代码 进行 设置 : 


Configuration conf = new Configuration();// 实 例 配置 信息 
conf.locale = Locale. TAIWAN; // 修 改 本 地 化 语言 


当 配 置 文件 设置 完毕 后 ， 还 需要 更 新 当前 项 目的 配置 即 可 : 


this.getResources () .updateConfiguration (conf，nul1) ;// 更 新 


重新 设置 模拟 器 或 者 设备 的 语言 为 非 繁 体 中 文 ， 并 且 重 新 运行 项 目 ， 效 果 如 图 6-39 所 


示 。 


English (New Zealand) 
English (Singapore) 
English (United Kingdom) 
English (United States) 


Espafiol 


Francais (Belgique) 


图 6-39 ”强制 语言 版 本 


从 图 6-39 中 可 以 看 到 ， 将 设备 语言 选择 英文 ， 运 行 项 目 因 强 制 设置 了 台湾 语言 ， 所 以 项 
目 索引 的 values 是 values-zh-rTW， 显 示 为 中 文 繁体 。 强 制 语言 版 本 只 是 针对 当前 运行 的 项 目 
生效 ， 不 会 影响 整个 设备 的 显示 语言 。 

需要 注意 的 是 ， 在 多 语言 应 用 开发 中 ， 还 经 常用 到 一 个 方法 Locale.getDefault()， 这 个 方 
法 的 作用 是 获取 当前 默认 语言 区 域 。 

通过 本 小 节 的 讲解 ， 读 者 可 以 更 好 地 体会 利用 xml 定义 Android 应 用 多 语言 所 带 来 的 方便 。 


本 章 小 结 


本 章 介绍 了 一 个 游戏 开发 的 高 级 知识 ， 内 容 包括 360” 平 滑 游 戏 导航 摇 杆 、 多 和 触 点 实现 
图 片 缩放 、 触 屏 手势 识别 、 加 速度 传感器 、9patch 工具 的 使 用 、 代 码 实现 截屏 功能 、 效 率 检 
视 工具 、 游 戏 视图 与 系统 组 件 共同 显示 、 蓝 牙 对 战 游戏 、 网 络 游戏 开发 基础 、 本 地 化 与 国际 
化 等 ， 这 些 内 容 都 是 游戏 开发 人 员 必须 掌握 的 。 
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从 本 章节 可 以 学 习 到 ; 


党 Box2D 概述 
学 将 Box2D 类 库 导 入 Android 
项 目 中 


学 物理 世界 与 手机 屏幕 坐 
标 系 之 间 的 关系 


学 创建 Box2D 物理 世界 
学 创建 矩形 物体 

学 让 物体 在 屏幕 中 展现 

党 创建 自 定义 多 边 形 物体 
学 物理 世界 中 的 物体 角度 


第 7 章 


Box2D 物理 引擎 


创建 圆 形 物体 

多 个 Body 的 数据 赋值 
设置 Body 坐标 与 给 Body 
施加 力 


Body 碰撞 监听 、 筛 选 与 
Body 传感器 


关节 
通过 AABB 获取 Body 
物体 与 关节 的 销毁 


Android 游 戏 编程 之 从 零 开 始 


/7.1 


Box2D 概述 


Box2D 是 一 款 用 于 2D 游戏 的 物理 引擎 。 在 Box2D 物理 世界 里 ， 创 建 出 的 每 个 物体 都 更 


接近 于 真实 世界 中 的 物体 ， 让 游戏 中 的 物体 运动 起 来 更 加 真实 可 信 ， 让 游戏 世界 看 起 来 更 具 
交互 性 。 
Android 平台 常见 的 十 几 款 游戏 引擎 中 ， 例 如 : Rokon、AndEngine、libgdx 等 物理 引擎 
都 封装 了 Box2D 物理 引擎 ， 可 见 Box2D 在 物理 引擎 中 占据 了 多 重要 的 位 置 。 

Box2D 在 很 多 平台 都 有 对 应 的 版 本 : Flash 版 本 、Iphone 版 本 、Java 版 本 (JBox2D) 等 
等 ， 在 本 书 中 开发 Android 语言 采用 的 是 Java， 所 以 这 里 介绍 的 对 应 Box2D 平台 也 是 Java 平 
台 ， 称 为 JBox2D， 对 应 的 版 本 为 JBox2d 2.0。 


/ 2 将 Box2D 类 库 导 入 Android 项 目 中 


三 了 》 新 建 项 目 “HelloBox2d"” 
全 到 了 》 然后 在 项 目 里 添加 一 个 “lib” 目 录用 寺 


添加 Box2D 类 库 到 Android 项 目 详细 步骤 如 下 : 


( 创建 Android 项 目 与 之 前 创建 项 目 步骤 无 差异 ) 。 
存放 Box2D 类 库 ( “jar”) 。 


全 汕 囊 右键 项 目 “HelloBox2d”， 选 中 “New” 一 “Folder"” 选项， 然后 出 现 “New 
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Folder” 窗 口 ， 如 图 


7-1 所 示 。 


国 New Folder 


Folder 


Create a new folder resource. 


Enter or select the parent folder 
HelloBox2d 


区 HelloBow2d 


LD 


7-1 New Folder 
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图 7-1 所 示 的 窗口 中 ， 在 “Folder name” 文 本 框 中 填写 目录 名 ， 这 个 目录 名 可 以 自 定 义 ， 
一 般 导入 外 部 类 库 目 录 都 使 用 lib 与 libs 来 命名 ， 然 后 单 击 “Finish” 按 钮 完成 目录 的 创建 。 

此 时 只 是 将 Box2D 提供 的 类 库 放 入 Android 项 目 中 ， 但 是 并 没有 添加 到 项 目的 类 库 中 ， 
所 以 还 需要 将 Box2D 包 添 加 到 项 目 类 库 中 ! 


右 击 项 目 “HelloBox2d” 选 中 “Properties ”一 “Java Build Path” 一 “Libraries” 一 > 
“Add JARs...”， 选 中 “HelloBox2d” 项 目下 lib 目录 下 的 Jbox2d 类 库 的 jar 包 ， 最 
后 一 直 单 击 “OK” 按 钮 返回 即 可 ， 如 图 7-2、 图 7-3 所 示 。 


ee Order end Erpon] 


IARs and ciass folders on the build pth 
玉 Android 16 


图 7-2 项 目 配置 


en edaa 


Choose the archives to be added to the build path: 


(ype filter te 


7-3 项 目 中 添加 Box2d 类 库 


-一 一 


323 


Android 游 戏 编程 之 从 零 开 始 


到 此 ， 在 Android 项 目 中 添加 JBox2D 物理 引擎 类 库 的 步骤 就 结束 了 ， 现 在 就 开始 进入 
Box2D 引擎 的 物理 世界 吧 ! 


.了 3 物理 世界 与 手机 屏幕 坐标 系 之 间 的 关系 


本 节 来 讲解 一 下 物理 世界 与 手机 屏幕 坐标 系 之 间 的 关系 。 假 设 创建 一 个 200 米 的 物理 世 
界 ， 然 后 观察 其 物理 世界 与 手机 屏幕 之 间 的 坐标 系 关 系 ， 如 图 7-4 所 示 。 


人 


(-100m,-100m) (100m,0m) 


(0,0) 


之 X 轴 方向 


(Om,100m) (100m,100m) 
Y 轴 方向 
7-4 物理 世界 与 手机 屏幕 坐标 系 关系 图 


从 图 74 中 可 以 很 清晰 的 看 出 ， 手 机 屏幕 的 左上 角 〈0.0) 坐标 ， 正 是 物理 世界 的 中 心 点 坐 
标 ; 手机 屏幕 绘制 图 形 时 ， 一 般 默认 以 左上 角 作为 锚 点 ! 而 在 Box2d 的 物理 世界 中 ， 一 个 新 的 
Body( 物 体 ) 等 被 创建 出 来 之 后 ， 默 认 以 其 质心 (可 以 近似 为 中 心 点 ) 作为 锚 点 ， 如 图 7-5 所 
示 ， 是 “在 屏幕 上 绘制 一 张 图 片 ， 并 且 在 物理 世界 中 添加 一 个 物体 ”的 位 置 关 系 图 。 


(3) 
物体 与 绘制 的 物体 绘制 对 比 图 
图 7-5 默认 放置 的 位 置 对 比 图 
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除 此 之 外 ，Box2D 为 了 使 物体 与 关节 等 更 加 贴切 的 模拟 现实 ， 在 Box2D 引擎 中 使 用 的 长 
度 单位 是 “ 米 Cm) ”， 所 以 Box2D 引擎 中 的 一 些 方法 的 长 度 参数 不 再 是 以 像素 为 单位 ， 而 
是 需要 转换 成 “ 米 ”; 反之 ， 从 Box2D 引擎 函数 返回 值 中 得 到 的 长 度 值 也 是 以 “ 米 ” 做 单位 
的 ， 使 用 其 值 前 需要 将 其 转换 为 像素 ， 然 后 再 使 用 。 

关于 米 与 像素 之 间 的 换算 关系 ， 其 实 是 通过 自 定义 一 个 现实 与 屏幕 的 比例 关系 进行 换算 
的 ， 后 续 章 节 会 有 讲解 。 


/ .A 创建 Box2D 物理 世界 


World (jbox2d.dynamics.World) 类 就 是 Box2D 引擎 中 的 物理 世界 。 不 管 是 Body ( 物 
体 ) 还 是 Joint (关节 ) 都 必须 放 在 Box2D 这 个 物理 世界 中 ， 因 为 物理 世界 也 是 有 范围 的 ， 
- 且 物 体 和 关节 不 在 世界 范围 内 ， 它 们 将 不 会 进行 物理 模拟 。 
下 面 就 来 创建 一 个 物理 世界 ， 范 例 项 目 对 应 的 源 代码 为 “7-4 (Box2d 物理 世界 ) ”。 
首先 看 一 下 World 类 的 构造 函数 : 


World (AABB world AABB,Vec2 gravity,boolean doSleep) 
World 类 只 有 这 一 种 构造 方式 ， 它 的 三 个 参数 的 含义 如 下 : 


。 第 一 个 参数 : AABB 类 的 实例 ，AABB 表示 一 个 物理 模拟 世界 的 范围 ; 

@ 第 二 个 参数 : Vec2 实例 ， 一 个 二 维 世 界 向 量 类 ， 在 Box2D 中 的 最 常用 的 一 种 数据 类 
型 ; 在 这 里 表示 物理 世界 的 重力 方向 ; 

日 第 三 个 参数 : 布尔 值 ， 表 示 在 物理 世界 中 ， 如 果 静 止 不 动 的 物体 是 否 对 其 进行 休眠 。 
如 果 设 置 其 值 为 “true”， 则 表示 当 物 理 世界 开始 进行 模拟 时 ， 在 这 个 物理 世界 中 静 
止 没有 运行 的 物体 都 将 进行 休眠 ， 除 非 物 体 被 施加 了 力 的 作用 或 者 与 其 他 物体 发 生 碰 
撞 之 后 会 被 唤醒 ; 如 果 设置 其 值 设置 为 “false”， 那 么 物理 世界 中 的 所 有 物体 不 管 是 
否 静 止 都 会 一 直 进 行 物理 模拟 。 


创建 一 个 物理 世界 代码 如 下 : 


AABB aabb = new AABB() ;// 实例 化 物理 世界 的 范围 对 象 
aabb.lowerBound.set (-100，-100);// 设置 物理 世界 范围 的 左上 角 坐 标 
aabb.upperBound.set (100，100);// 设置 物理 世界 范围 的 右 下 角 坐 标 

Vec2 gravity = new Vec2(0，10) ;// 实例 化 物理 世界 重力 向 量 对 象 

World world = new World (aabb，gravity，true) ;// 实例 化 物理 世界 对 象 


以 上 代码 中 有 两 点 需要 注意 : 
(1) aabb 设置 物理 世界 范围 传 入 的 参数 ， 不 要 理解 成 像素 ! 在 Box2d 的 物理 世界 中 ， 被 
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认为 是 现实 生活 中 的 “ 米 (m) ”单位 。 

(2) 设置 物理 世界 的 重力 向 量 (gravity》， 其 两 个 参数 在 这 里 分 别 表示 物理 世界 中 的 X 
轴 与 Y 轴 方 向 上 的 重力 数值 ， 其 值 的 “+”“--” 号 在 这 里 表示 X 与 Y 轴 的 重力 方向 ，X 轴 
正 值 表示 向 右 ，Y 轴 正 值 表示 向 下 ; 因为 是 模拟 真实 世界 ， 所 以 这 里 的 X 重力 向 量 设置 为 
零 ，Y 轴 方向 设置 为 现实 生活 中 的 重力 值 ，10( 可 以 理解 为 10N》。 

刚才 的 一 段 代 码 就 已 经 创建 了 一 个 物理 世界 ， 但 只 是 定义 了 物理 世界 ， 并 没有 开始 进行 
物理 模拟 ， 所 以 还 需要 world 设置 物理 模拟 : 


world. step (float timeStep, int iterations); 


此 函数 表示 让 物理 世界 开始 进行 物理 模拟 ， 其 两 个 参数 含义 如 下 : 

@ 第 一 个 参数 : 表示 (时 间 步 ) 物理 世界 模拟 的 频率 ; 

e 第 二 个 参数 : 表示 ( 选 代 值 ) 选 代 值 越 大 模拟 越 精 确 ， 但 性 能 越 低 。 

@ 因 为 物理 世界 模拟 具有 持续 性 ， 所 以 应 该 将 设置 放 在 线程 中 ， 不 断 的 让 物理 世界 进行 
模拟 。 

@@ 时 间 步 : 应 该 与 游戏 的 刷新 率 相 同 ， 否 则 物理 世界 模拟 将 不 同步 。 

国 和 迭代 值 : 可 以 理解 为 在 单 次 时 间 步 中 进行 遍历 模拟 运算 数据 的 次 数 。 

@@ 在 Box2D 中 最 常 使 用 的 单位 是 float 浮 点 数 类 型 ， 作 者 刚 接触 Box2D 时 ， 在 定义 物理 
世界 模拟 频率 时 ， 写 成 了 以 下 错误 的 形式 : 
float timeStep = 1 / 60; 

这 样 写 导致 物理 世界 的 物体 永远 不 运动 ， 其 原因 就 是 “1/60” 的 值 永远 是 零 ! 所 以 正确 
书写 形式 应 该 是 : 
float timeStep = 1f / 60f; 

到 此 一 个 物理 世界 真正 的 创建 出 来 并 且 进 行 模拟 了 ， 但 是 因为 物理 世界 中 并 没有 放置 任 


何 的 物体 ， 所 以 运行 项 目 在 视觉 中 将 看 不 到 任何 的 效果 ， 下 面 的 章节 中 将 开始 在 物理 世界 中 
创建 物体 。 


作者 推荐 物理 模拟 的 频率 一 般 设 为 每 秒 60 帧 ， 和 迭代 设 为 10， 有 具体 设置 根据 应 用 和 设备 
性 能 情况 而 定 。 

在 后 续 创 建物 体 和 关节 的 章节 中 ， 很 多 代码 需要 传 入 以 “ 米 ” 作 为 单位 的 数值 ， 所 以 为 
了 便于 转换 ， 可 以 定义 一 个 成 员 变 量 : 


final float RATE = 30; 
在 Box2D 的 物理 世界 中 ， 为 了 更 加 贴切 的 模拟 现实 ， 部 分 函数 参数 不 青 使 用 “像素 ”而 
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是 用 “ 米 ” 表 示 。 为 了 能 将 模拟 的 物理 世界 映射 到 手机 屏幕 中 ， 定 义 一 个 屏幕 与 现实 世界 的 
比例 变量 “RATE”， 这 个 比例 值 作者 推荐 设置 为 30， 因 为 一 般 不 会 修改 此 值 ， 所 以 可 以 定 
义 为 final 常量 类 型 。 

还 要 注意 定义 此 变量 不 要 用 int 类 型 ， 应 该 用 float 类 型 。 否 则 会 发 生 如 同 timeStep 类 似 
的 状况 ， 此 值 可 能 会 比 预计 的 小 。 例 如 : 


2 
5 


int RATE = 30 -> 45/RATE 
float RATE = 30 -> 43/RATE 


/ .人 ”创建 矩形 物体 


在 学 习 创建 矩形 物体 之 前 ， 首 先 要 理解 几 个 基本 概念 : 

@ 大 家 可 以 想象 一 下 现实 生活 中 的 物体 基本 上 都 是 由 圆 形 与 多 边 形 组 成 ， 所 以 在 Box2d 
物理 世界 中 存在 两 种 2D 图 形 ， 一 种 是 圆 形 ， 一 种 是 多 边 形 。 

e@ 在 Box2D 中 物体 的 创建 都 应 该 设置 质量 、 摩 擦 力 与 恢复 力 这 三 个 基本 属性 。 

e@ Box2D 属于 工厂 模式 ， 也 就 是 说 在 Box2D 的 物理 世界 中 创建 物体 ， 都 是 由 工厂 
(World ) 生成 的 ， 而 不 是 new 出 来 的 。 


World 创建 一 个 物体 的 步骤 则 分 为 以 下 三 步 ; 
到 三》 首先 创建 物体 皮肤 。 
然后 创建 物体 刚体 。 
要 至》 最 后 通过 皮肤 与 刚体 信息 去 创建 一 个 物体 。 
简单 熟悉 了 Box2D 创建 一 个 物体 的 步骤 后 ， 下 面 来 创建 一 个 多 边 形 ， 添 加 在 物理 世界 


中 ， 项 目 对 应 的 源 代 码 为 “7-5 (在 物理 世界 中 添加 多 边 形 ) ”。 
在 项 目 中 添加 一 个 createPolygon 函数 ， 代 码 如 下 : 


public Body createPolygon (float x, float y, float width, float height, 
boolean isStatic) { 
// --- 创 建 多 边 形 皮肤 
PolygonDef pd = new PolygonDef(); // 实例 一 个 多 边 形 的 皮肤 
SEC 
pd.density = 0; // 设置 多 边 形 为 静态 
} else { 
pd.density = 1; // 设置 多 边 形 的 质量 
加 
pd.friction = 0.8f; // 设置 多 边 形 的 摩擦 力 
pd.restitution = 0.3f; // 设置 多 边 形 的 恢复 力 
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// 设置 多 边 形 快捷 成 盒子 (矩形 ) 

// 两 个 参数 为 多 边 形 宽 高 的 一 半 

pd.setAsBox (width / 2 / RATE, height / 2 / RATE); 
// --- 创 建 刚体 

BodyDef bd = new BodyDef(); // 实例 一 个 刚体 对 象 

// 设置 刚体 的 坐标 

bd.position.set((x + width / 2) / RATE, (y + height / 2) / RATE); 
// --- 创 建 Body (物体 ) 

Body body = world.createBody (bd) ; // 物理 世界 创建 物体 
body.createShape (pd) ; // 为 Body 添加 皮肤 
body.setMassFromShapes (); // 将 整个 物体 计算 打包 


return body; 


以 上 代码 中 ， 各 个 属性 的 含义 说 明 如 下 : 


ee 质量 (density ) : 当 物 体质 量 设置 为 0 时 ， 此 物体 视 为 “静态 物 休 ”; 所 谓 “ 静 态 物 
体 ”表示 不 需要 运动 的 物体 ; 比如 现实 生活 中 的 山 、 房 门 等 这 些 没有 外 力 不 会 发 生 运 
动 的 物体 则 认为 是 静态 不 运动 的 。 

e 摩擦 力 (ffiction) : 取 值 通常 设置 在 0~1 之 间 ，0 意味 着 没有 摩擦 ，1 会 产生 最 强 摩擦 。 

@ 恢复 力 (restitution ) : 取 值 也 通常 设置 在 0~ 1 之 间 ，0 表示 物体 没有 恢复 力 ，1 表示 
物体 拥有 最 大 恢复 力 。 

@ 刚体 设置 坐标 的 时 候 ， 需 要 传 入 现实 生活 中 的 “ 米 ” 做 为 参数 单位 ， 所 以 这 里 除 以 比 
例 “RATE” ， 将 像素 单位 转换 为 “ 米 ”。 

® BodyDef.position.set ( float x, float y) 方法 ， 设 置 Body 相对 于 物理 世界 的 坐标 。 


在 此 之 前 已 经 介绍 过 ， 物 理 世 界 中 创建 出 的 物体 默认 放置 的 位 置 是 以 物理 中 心 点 为 锚 
点 ， 那 么 为 了 让 其 与 手机 屏幕 绘制 图 形 位 置 重 合 ， 需 要 将 其 物理 的 X 位 置 加 上 其 宽 的 一 半 ， 
其 物体 的 Y 位 置 加 上 其 高 的 一 半 ， 这 样 就 相当 于 将 其 Body 的 锚 点 设置 成 了 左上 角 ， 如 图 7-6 
所 示 。 


物理 世界 中 ， 物 体 
默认 放置 的 位 置 中 的 绘制 图 形 的 默认 
位 置 重合 
图 7-6 物体 与 图 形 坐标 重合 


项 目 运行 效果 如 图 7-7 所 示 。 
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7-7 ”矩形 Body 项 目 运行 效果 图 


. 〇 ”让 物体 在 屏幕 中 展现 


从 7.4 节 “ 创 建 Box2D 物理 世界 ”到 7.5 节 “ 创 建 矩 形 物体 ”这 两 小 节 中 可 以 看 出 ， 貌 
似 这 一 切 都 与 屏幕 绘制 没有 任何 的 关系 。 

是 的 ， 屏 幕 绘制 的 图 形 与 Box2D 无 关 ! Box2D 引擎 只 负责 提供 物理 世界 的 模拟 数据 。 换 
言 之 ， 如 果 想 让 屏幕 中 显示 一 个 附 有 重力 的 图 形 ， 那 么 则 需要 一 个 重力 物体 运动 轨迹 的 数 
据 ， 而 Box2D 提供 的 Body 正 是 一 个 拥有 重力 的 物体 。 通 过 将 Body 在 模拟 的 物理 世界 中 的 
运动 数据 传 给 绘制 的 图 形 ， 绘 制 的 图 形 就 会 沿 着 提供 的 运动 轨迹 来 运行 ， 也 就 相当 于 图 形 拥 
有 了 重力 。 


Vec2 position = body.getPosition(); 
polygonX = position.x * RATE-polygonWidth/2; 
polygonY = position.y * RATE-polygonHeight/2; 


通过 Body 的 getPosition 函数 得 到 Body 的 中 心 点 的 位 置 ， 然 后 通过 比例 转换 成 像素 ， 再 
分 别 赋值 给 屏幕 绘制 的 图 形 X,Y 坐标 。 

还 要 注意 一 点 : 此 方法 获取 的 是 物体 的 中 心 点 坐标 ， 所 以 还 需要 将 其 X 坐标 减 去 物体 的 
宽 的 一 半 ，Y 坐标 减 去 物体 的 高 的 一 半 ， 得 到 其 左上 角 坐 标 。 当 然 如 果 图 形 是 以 中 心 点 进行 
绘制 的 话 ， 就 可 以 获取 中 心 点 直接 将 坐标 传递 给 绘制 的 图 形 即 可 。 

因为 物理 世界 是 在 不 断 的 模拟 ， 所 以 也 要 不 断 去 获取 物体 在 物理 世界 的 最 新 坐标 ， 然 后 
传递 给 绘制 的 图 形 ， 图 形 就 会 按照 物体 在 物理 世界 中 的 运动 轨迹 去 “运动 ”。 


329 


Android 游 戏 编程 之 从 零 开 始 


/创建 自 定义 多 边 形 物体 


在 7.5 节 中 讲解 了 如 何 创建 一 个 矩形 ， 其 实 创建 一 个 自 定义 多 边 形 的 过 程 是 类 似 的 ， 只 
是 不 再 利用 PolygonDef.setAsBox() 函 数 快捷 创建 成 一 个 矩形 形状 ， 而 是 通过 设置 自 定义 的 多 变 
形 的 各 个 顶点 ， 从 而 创建 一 个 多 边 形 。 

需要 注意 的 一 点 是 ， 在 Box2D 中 只 能 创建 凸 多 边 形 ， 而 不 允许 创 建 凹 多 边 形 ! 

下 面 就 来 看 一 个 创建 自 定义 三 角形 的 范例 ， 项 目 对 应 的 源 代 码 为 “7-7〈 添 加 自 定义 多 边 
形 ) ”。 

首先 ， 添 加 一 个 createMyShape 函数 ， 代 码 如 下 : 


public Body createMyShape (float[] vertices, float x, float y, float wy 
float h, boolean isStatic) { 
// --- 创 建 三 角形 皮肤 
PolygonDef cd = new PolygonDef(); // 实例 一 个 三 角形 的 皮肤 
if (isStatic) { 
cd.density = 0; // 设置 三 角形 为 静态 
} else { 
cd.density = 1; // 设置 三 角形 的 质量 
lL 
cd.friction = 0.8f; // 设置 三 角形 的 摩擦 力 
cd.restitution = 0.3f; // 设置 三 角形 的 恢复 力 
// 设 置 三 角形 的 每 个 顶点 
cd.addVertex (new Vec2 (vertices[0], vertices[1])); 
cd.addVertex (new Vec2 (vertices[2], vertices[3])); 
cd.addVertex (new Vec2 (vertices[4], vertices[5])); 
// --- 创 建 刚体 
BodyDef bd = new BodyDef(); // 实例 一 个 刚体 对 象 
// 设置 刚体 的 坐标 
bd.position.set((x +w/ 2) / RATE, (y + h / 2) / RATE); 
// --- 创 建 Body (物体 ) 
Body body = world.createBody(bd) ; // 物理 世界 创建 物体 
body.createShape (cd) ; // 为 Body 添加 皮肤 
body.setMassFromShapes (); // 将 整个 物体 计算 打包 


return body; 


Box2D 在 将 所 有 项 点 进行 闭合 时 ， 是 按照 顺 时 针 进 行 顶点 连接 的 。 
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项 目 运行 效果 如 图 7-8 所 示 。 


国 


图 7-8 添加 自 定义 多 边 形 项 目 截图 

大 家 看 到 图 7-8 所 示 的 效果 ， 可 能 在 纳 闽 为 什么 三 角形 立 在 了 矩形 上 。 其 实 大 家 不 要 惊 

讶 ， 虽 然 这 种 现象 在 现实 中 基本 是 不 可 能 的 ， 但 是 在 Box2D 这 个 模拟 的 物理 世界 中 都 是 理想 
化 的 物体 效果 ， 所 以 这 种 理想 化 的 物理 状态 也 就 见怪 不 怪 了 。 


.六 物理 世界 中 的 物体 角度 


前 面 介绍 了 Body 的 X、Y 坐标 属性 ， 在 现实 生活 两 个 物体 发 生 碰撞 后 ， 除 了 位 置 坐标 
发 生 偏 移 外 ， 碰 撞 的 两 个 物体 角度 一 般 也 会 发 生 改变 。 所 以 ， 在 Box2D 模拟 的 物理 世界 中 ， 
物体 (Body) 除了 拥有 位 置 X、Y 坐标 这 一 重要 属性 外 ， 还 具有 角度 属性 。 

通过 Body 类 的 getAngle() 方 法 能 得 到 Body 的 弧度 ， 通 过 弧度 与 角度 之 间 的 转换 公式 来 
转换 成 角度 ， 然 后 利用 其 角度 旋转 绘制 的 图 形 角度 即 可 : 


@ 弧度 一 角度 : body.getAngle()/180*Math.PI; 

e@ 角度 一 弧度 : body.getAngle()/Math.PI*180。 

修改 7.7 节 的 项 目 代码 ， 添 加 一 个 静态 矩形 Body 放 在 其 自 定义 的 三 角形 的 下 方 ， 让 其 发 
生 碰 撞 ， 观 察 其 角度 的 变化 ， 如 图 7-9 所 示 ， 本 节 项 目 对 应 的 源 代码 为 “7-7 (添加 自 定义 多 
边 形 ) ”。 


331 


Android 游 戏 编程 之 从 零 开 始 


图 7-9 Body 角度 的 改变 前 后 对 比 图 


创建 圆 形 物体 


创建 圆 形 Body 与 创建 德 形 也 类 似 ， 只 是 皮肤 使 用 CircleDef 来 创建 ， 然 后 设置 皮肤 的 半 
径 即 可 ， 下 面 就 来 创建 一 个 自 定义 三 角形 ， 对 应 的 源 代码 为 “7-9〈 在 物理 世界 中 添加 圆 
形 六 ”5 

在 项 目 中 添加 一 个 createCircle 函数 ， 代 码 如 下 : 


Public Body createCircle (float x, float y, float r, boolean isStatic) { 
// --- 创 建 圆 形 皮肤 
CircleDef cd = new CircleDef(); // 实例 一 个 圆 形 的 皮肤 
if (isStatic) { 
cd.density = 0; // 设置 圆 形 为 静态 
} else { 
cd.density = 1; // 设置 圆 形 的 质量 


cd.friction = 0.8f; // 设置 圆 形 的 摩擦 力 
cd.restitution = 0.3f; // 设置 圆 形 的 恢复 力 

cd.radius = 工 / RATE; // 设置 圆 形 的 半径 

// --- 创 建 刚体 

BodyDef bd = new BodyDef(); // 实例 一 个 刚体 对 象 
bd.position.set((x + r) / RATE，(y + r) / RATE); // 设置 刚体 的 坐标 
// --- 创 建 Body (物体 ) 

Body body = world.createBody (bd) ; // 物理 世界 创建 物体 
body.createShape (cd) ; // 为 Body 添加 皮肤 
body.setMassFromShapes (); // 将 整个 物体 计算 打包 
return body; 


在 Android 中 Canvas 常用 的 有 两 种 绘制 圆 形 的 方式 ， 一 种 利用 drawArc， 另 外 一 种 是 利 
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用 drawCircle， 这 两 种 虽然 一 个 是 绘制 椭圆 ， 一 个 是 绘制 圆 形 ， 但 是 两 种 都 可 以 绘制 圆 形 ， 
其 主要 的 区 别 在 于 drawCircle 函数 是 要 求 传 入 圆心 的 坐标 。 

所 以 ， 在 使 用 body.getPosition() 将 Body 中 心 点 坐标 传递 给 绘制 的 图 形 坐 标 时 ， 其 Body 
的 X,Y 坐标 是 否 要 进行 减 去 半径 ， 完 全 取决 于 绘制 图 形 的 方式 。 如 果 绘 制 圆 形 是 使 用 
drawCircle 进行 绘制 ， 那 么 获取 的 Body 的 中 心 点 坐标 可 以 直接 传递 给 绘制 的 圆 形 坐标 ， 如 果 
使 用 了 drawArc 函数 ， 则 需要 在 Body 与 绘制 图 形 的 坐标 传递 值 时 ，X、Y 都 需要 减 去 半径 
长 5 

项 目 运行 效果 如 图 7-10 所 示 。 


图 7-10 添加 圆 形 Body 项 目 运行 效果 图 


| DO。 多 个 Body 的 数据 赋值 


在 前 面 的 章节 中 ， 不 管 是 创建 矩 形 Body， 还 是 圆 形 Body， 为 了 让 其 Body 的 坐标 、 角 度 
等 属性 能 传递 给 绘制 的 图 形 ， 都 要 声明 其 对 应 的 一 个 Body 实例 。 但 是 如 果 Body 需要 创建 很 
多 个 的 时 候 ， 以 前 的 数据 传递 方式 就 显 的 很 笨拙 ， 工 作 量 也 很 大 。 


7.10.1 遍历 Body 
在 World 类 中 有 两 个 常用 的 函数 : 


@_ world.getBodyCount(): 此 函数 返回 world 中 所 有 body 的 数量 ， 但 是 要 注意 ， 新 建 一 个 
物理 世界 ， 使 用 此 方法 时 ， 不 会 得 到 零 ， 而 是 返回 一 个 1; 

ee world.getBodyList0: 此 函数 表面 上 看 应 该 是 返回 物理 世界 中 的 Body 的 链表 ， 其 实 它 
返回 的 是 一 个 Body 对 象 ， 就 是 World 中 Body 链表 的 表 头 。 


既然 world 中 的 Body 是 以 链表 方式 存放 的 ， 那 就 应 该 能 获取 到 下 一 个 Body 的 函数 。 没 
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错 ! 在 Body 类 中 有 个 body.m_next 函数 ， 此 函数 就 是 用 来 索引 Body 链表 的 下 一 个 Body。 使 
用 这 个 函数 ， 就 可 以 通过 循环 ， 遍 历 出 world 中 所 有 的 Body。 
下 面 就 来 实现 多 个 Body 遍历 绘制 ， 项 目 对 应 的 源 代码 为 “7-10-1 (遍历 Body) ”。 


// 得 到 Body 链表 的 表 头 

Body body = world.getBodyList(); 

// 通 过 world .getBodyCount () 得 到 循环 遍历 Body 的 次 数 

for (int i = 1; i < world.getBodyCount(); i++) { 
// 得 到 当前 body 的 角度 
float angle = (float) (body.getAngle() * 180 / Math.PI); 
// 得 到 当前 body 的 质点 X 坐标 
float bodyCenterX = body.getPosition () .xxRRTE 
// 得 到 当前 body 的 质点 Y 坐标 
float bodyCenterY = body.getPosition () .y*RATE; 
// 链 表 指向 下 一 个 body 
body = body.m next; 


for 循环 是 从 1 开始 的 ， 因 为 world.getBodyCount() 默 认 返 回 1。 


通过 此 方式 ， 可 以 省 去 Body 与 绘制 图 形 数 据 传 递 的 步骤 ， 直 接 在 绘制 图 形 时 ， 人 遍历 取 
出 每 个 Body 的 坐标 等 属性 作为 绘制 图 形 参 数值 。 

利用 Body 链表 遍历 Body 虽然 方便 ， 省 去 了 很 多 Body 对 象 的 声明 ， 但 是 存在 一 个 缺 
点 : 遍历 获取 每 个 Body 的 坐标 与 角度 的 逻辑 代码 都 放 在 了 绘制 图 形 中 ， 会 造成 其 他 图 形 的 

项 目 运 行 效果 如 图 7-11 所 示 。 


口 口 口 口 口 品 


总 Ag 


图 7-11 遍历 Body 项 目 效果 图 
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7.10.2” 自 定义 类 关联 Body 


在 游戏 开发 中 ， 都 会 有 很 多 自 定义 的 类 ， 例 如 飞行 射击 类 型 的 游戏 中 的 飞机 、 子 弹 等 都 
会 是 独立 的 类 ， 那 么 下 面 就 来 实现 对 自 定义 类 型 进行 遍历 数据 。 
首先 介绍 Body 的 一 个 属性 “m_userData”， 它 是 一 个 Object 类 型 ， 其 主要 用 途 是 保存 
-个 Object 实例 ， 这 样 就 可 以 将 自 定义 的 类 型 保存 到 Body 的 这 个 m_userData 里 ， 通 过 遍历 
Body 时 取出 其 实例 并 进行 操作 。 这 么 一 说 ， 大 家 就 大 概 知道 如 何 使 用 了 ， 下 面 通过 遍历 自 定 
义 图 片 类 来 进行 更 加 详细 的 讲解 ， 项 目 对 应 的 源 代 码 为 “7-10-2 (Body 的 m_userData) ”。 
新 建 一 个 图 片 类 “BitmapBody.java”: 


Public class BitmapBody { 
private Bitmap bmp;// 图 片 
private float x，y，angle;// 图 片 的 坐标 和 角度 


Public BitmapBody (Bitmap bmp, float x, float Y) { 
this.bmp = bmp; 
this.x = x; 
this.y VY? 


; 
// 绘制 图 片 
Public void draw (Canvas canvas, Paint paint) { 
canvas.save (); 
canvas.rotate(angle, x + bmp .getNidth() / 2, 
y + bmp.getHeight () / 2); 
canvas.drawBitmap (bmp, x, y, paint); 
canvas.restore(); 


i 

// 设置 角度 

public void setAngle (float angele) { 
this.angle = angele; 


// 设置 X 轴 坐标 
Public void setX (float bodyX) { 
this.x = bodyxX; 


} 

// 设置 Y 轴 坐 标 

Public void setY(float y) { 
this.y = y; 

// 获取 图 片 的 宽 


public int getW() { 
return bmp .getwidth(); 


// 获取 图 片 的 高 
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public int getH() { 
return bmp.getHeight (); 
} 


此 类 很 简单 ， 就 不 多 做 说 明 。 下 面 来 看 如 何 将 自 定义 的 图 片 类 关联 其 Body。 添 加 一 个 
createCircle 函数 ， 代 码 如 下 : 


public Body (Bitmap bmp, float x, float y, float width, 
float height, boolean isStatic) { 
// --- 创 建 图 片 Body 皮肤 
PolygonDef pd = new PolygonDef(); // 实例 一 个 图 片 Body 的 皮肤 
if (isStatic) { 
pd.density = 0; // 设置 图 片 Body 为 静态 
} else { 
pd.density = 1; // 设置 图 片 Body 的 质量 
pqd.friction = 0.8f; // 设置 图 片 Body 的 摩擦 力 
pd.restitution = 0.3f; // 设置 图 片 Body 的 恢复 力 
// 设置 图 片 Body 快捷 成 盒子 (矩形 ) 
// 两 个 参数 为 图 片 Body 宽 高 的 一 半 
pd.setAsBox (width / 2 / RATE, height / 2 / RATE); 
// --- 创 建 刚体 
BodyDef bd = new BodyDef(); // 实例 一 个 刚体 对 象 
// 设置 刚体 的 坐标 
bd.position.set((x + width / 2) / RATE, (y + height / 2) / RATE); 
// --- 创 建 Body (物体 ) 
Body body = world.createBody (bd); // 物理 世界 创建 物体 
// 在 body 中 保存 自 定义 类 
body.m userData = new BitmapBody (bmp, x, y); 
body.createShape (pd) ; // 为 Body 添加 皮肤 
body.setMassFromShapes (); // 将 整个 物体 计算 打包 
return body; 


创建 Body 的 过 程 与 创建 一 个 矩形 Body 基本 一 致 ， 唯 一 不 同 点 就 是 将 自 定义 类 赋值 给 了 
Body 的 “m_userData” 属 性 。 
下 面 来 看 遍历 Body 与 自 定 义 图 片 类 数据 的 传递 : 


// 得 到 Body 链表 的 表 头 

Body body = world.getBodyList (); 

// 通过 world.getBodyCount () 得 到 循环 遍历 Body 的 次 数 

for (int i = 1; i < world.getBodyCount(); i++) { 
// 从 body 中 获取 其 自 定义 的 BitmapBody 实例 
BitmapBody bb = (BitmapBody) body.m userData; 
// 得 到 当前 body 的 角度 
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float angele = (float) (body.getAngle() * 180 / Math.PT) 
// 得 到 当前 body 的 质点 X 坐标 

float bodyX = body.getPosition() .x * RATE - bb.getW() / 2; 
// 得 到 当前 body 的 质点 Y 华 标 

float bodyY = body.getPosition().y * RATE - bb.getH() / 2; 
// 链表 指向 下 一 个 body 

bb.setAngle (angele); 

bb .setX (bodyX); 

bb.setY (bodqyY) 

// 链表 指向 下 一 个 body 

body = body.m next; 


然后 看 绘图 方式 : 


// 得 到 Body 链表 的 表 头 

Body body = world.getBodyList (); 

// 通过 world.getBodyCount () 得 到 循环 遍历 Body 的 次 数 

for (int i = 1; i < world.getBodyCount(); i++) { 
// 从 body 中 获取 其 自 定义 的 BitmapBody 实例 
BitmapBody bb = (BitmapBody) body.m userData; 
// 调用 自 定义 图 片 类 的 draw 方法 
bb.draw (canvas, paint); 
// 链表 指向 下 一 个 body 
body = body.m next; 


最 后 来 看 项 目 运行 的 效果 ， 如 图 7-12 所 示 。 


图 7-12 自 定义 图 片 类 项 目 运行 效果 图 
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/ .1 1 设置 Body 坐标 与 给 Body 施加 力 


7.11.1 ”手动 设置 Body 的 坐标 
如 需要 设 定 Body 的 坐标 ， 使 用 Body 类 中 下 面 这 个 函数 : 


setXForm (Vec2 position, float angle); 


这 个 函数 的 两 个 参数 含义 如 下 : 
@ 第 一 个 参数 : 指 的 是 Body 在 物理 世界 中 的 坐标 ; 
@ 第 二 个 参数 : 指 的 是 Body 的 角度 。 


7.11.2 ”给 Body 施加 力 


在 前 面 的 章节 中 学 习 了 在 物理 世界 中 如 何 添加 物体 Body 的 方法 。 那 么 ， 如 果 想 让 物体 
Body 单方 向 地 沿 着 X 轴 或 者 Y 轴 移 动 ， 或 者 让 Body 沿 着 抛物 线 运 动 等 等 ， 该 怎么 做 呢 ? 
在 Box2D 的 Body 类 中 ， 提 供 了 一 个 给 Body 施加 力 的 函数 : 


applyForce (Vec2 force，Vec2 point) 


此 方法 需要 传 入 两 个 Vec2 向 量 实例 作为 参数 : 


@ 第 一 个 参数 : 表示 力 的 义 与 Y 轴 的 力度 ， 其 值 拥 有 “+”“-” 属 性 ; 
@ 第 二 个 参数 : 表示 当前 调用 此 方法 的 Body 所 在 物理 世界 的 位 置 。 


而 使 用 getWorldCenter() 方 法 可 以 获取 Body 在 物理 世界 中 所 处 的 位 置 。 看 到 这 个 方法 可 以 
想到 ， 如 果 需 要 使 Body 按照 一 个 抛物 线 进 行 运动 ， 那 么 只 要 施加 一 个 X 轴 方 向 的 力度 ， 
个 立轴 方向 的 力度 ， 然 后 通过 调整 力度 值 的 大 小 和 力度 值 的 方向 〈 正 负 号 ) 就 可 以 组 合 出 很 
多 的 运动 轨迹 。 

下 面 就 来 做 一 个 简单 的 “ 炮 龙 小 球 ” 的 实例 ， 项 目 对 应 的 源 代 码 为 “7-11 (为 Body 施加 
为 

先 看 项 目 运行 效果 ， 如 图 7-13 所 示 。 
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图 7-13 给 Body 施加 力 


具体 实现 步骤 如 下 : 


仍 丕 对 了》 首先 创建 “MyCircle” 圆 形 类 ， 便 于 Body 遍历 传 值 ， 代 码 如 下 所 示 。 
public class MyCircle { 

// 圆 形 的 宽 高 与 半径 

filont Xr Vr rT 

Public MyCircle(float x, float y, float r) { 


this.x = x; 
this.y = y; 
this.r = r; 

} 

// 设 置 圆 形 的 X 坐标 

Public void setX (float x) { 
ED 全 二 < 

// 设 置 半径 的 Y 坐标 

Public void setY(float y) { 
this.y = y; 

} 

/ /绘制 圆 形 


Public void draw (Canvas canvas, Paint paint) { 
canvas .drawArc (new RectF (x, y, x + 2*r, y + 2*r), 
0, 360, true, paint); 


圆 形 类 设计 的 比较 简单 ， 值 得 注意 的 是 绘制 函数 draw。 这 里 以 drawArc 的 方式 去 绘制 
形 ， 所 以 当 Body 与 图 形 传 X、Y 坐标 时 ， 要 记得 分 别 减 去 Body 的 宽 和 高 的 一 半 。 如 果 这 
使 用 drawCircle 的 话 ， 那 么 Body 与 图 形 传 坐标 值 就 不 需要 做 减 值 操作 了 ， 因 为 默认 获取 抢 
是 Body 的 中 心 点 坐标 。 


加 


由 


他 了 吕 


要 如 3》 创建 国 形 Body， 代 码 如 下 所 示 。 
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// 实例 需要 施加 力 的 body 小 球 ， 因 为 在 后 续 的 按键 处 理 中 ， 
/ /我 们 需 对 齐 小 球 施 加 力 的 操作 ; 所 以 body1 声明 为 成 员 变 量 ; 
bodyl = createCircle(20, 120, 10, false); 
// ---- 在 物理 世界 中 添加 多 个 动态 圆 形 Body 
Zor int = 0 do cD 
createCircle(60, 50+i * 17, 10, false); 


} 

// 添加 屏幕 下 方 添加 多 个 静态 物体 

Por int 1 = "07 < Slr) 
createCircle(i * 20, 150, 10, true); 


} 
// 创建 圆 形 Body 函数 
Public Body createCircle (float x, float y, float r, boolean isStatic)1{ 
CircleDef cd = new CircleDef (); 
if (isStatic) { 
cd.density = 0; 
} else { 
cd.density = 1; 
1 
cd.friction = 0.8f; 
cd.restitution = 0.3f; 
cd.radius = r / RATE; 
BodyDef bd = new BodyDef (); 
bd.position.set((x + r) / RATE, (y + r) / RATE); 
Body body = world.createBody (bd); 
body.m userData = new MyCircle(x, y, r); 
body.createShape (cd); 
body.setMassFromShapes (); 
return body; 
} 


BE 二 网 形 Body 与 圆 形 图 形 坐标 传 值 遍 历 ， 代 码 如 下 所 示 。 


// 取出 body 链表 表 头 

Body body = wor1ld.getBodyList() 

for (int i = 1; i < world.getBodyCount(); i++) { 
// 设置 MyCircle 的 X，Y 坐标 
MyCircle mc = (MyCircle) body.m userData; 
mc.setX (body.getPosition().x * RATE - mc.r); 
mc .setY (body.getPosition().y * RATE - mc.r); 
// 将 链表 指针 指向 下 一 个 body 元 素 
body = body.m next; 


| 


} 
绘制 Body， 代 码 如 下 所 示 。 
// 遍 历 取出 body， 通 过 body 的 m_userData 属性 得 到 其 MyCircle 实例 
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Body body = world.getBodyList (); 

for (int i = 1; i < world.getBodyCount(); i++) { 
// 每 个 MyCircle 实例 调用 其 绘制 函数 
((MyCircle) body.m userData) .draw(canvas, paint); 
body = body.m next; 

} 


他 亚 印 按键 事件 中 为 小 球 施加 力 ， 代 码 如 下 所 示 。 


Q@Override 

public boolean onKeyDown (int keyCode, KeyEvent event) { 
Vec2 vForce = new Vec2(150, -150); 
bodyl .applyForce (vForce, bodyl.getWorldCenter ()); 
return true; 


当 手 动 为 一 个 Body 施加 一 个 力 ， 即 使 它 在 受 力 之 前 处 于 静止 正 休眠 状态 ， 也 会 被 唤 
醒 ， 但 是 要 注意 最 好 不 要 给 静态 物体 Body 施加 力 ， 因 为 对 一 个 静态 物体 施加 力 ， 虽 然 这 个 
力 存在 ， 但 其 实 是 起 不 到 作用 的 ， 静 态 物 体 始终 静止 。 


Body 碰撞 监听 、 和 筛选 与 Body 传感器 


7.12.1 ”Body 碰撞 接触 点 监 


在 Box2D 中 提供 了 一 个 碰撞 监听 器 接口 “ContactListener”， 使 用 接口 需要 重 写 它 的 四 
个 抽象 函数 : 


Qoverride 

Public void add (ContactPoint arg0) { 

上 

Q@Override 

public void persist (ContactPoint arg0) { 
} 

Q@Override 

Public void remove (ContactPoint arg0) { 
] 

Q@Override 

Public void result (ContactResult arg0) { 
| 


ContactListener 接口 的 4 个 函数 的 含义 为 : 
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add 函数 : 发 生 碰撞 ， 有 新 的 接触 点 时 响应 的 函数 ; 
persist 函数 : 当 已 存在 的 接触 点 仍 存在 时 响应 的 函数 ; 
remove 函数 : 当 存在 的 接触 点 被 删除 时 响应 的 函数 ; 
result 函数 : 每 次 时 间 步 监听 ， 如 仍 有 触 点 存在 则 被 响应 ; 


通过 这 4 个 函数 中 的 参数 ContactPoint 类 的 实例 ， 可 以 获取 到 相互 之 间 碰 挤 的 两 个 Body 
实例 等 等 ， 获 取 Body 的 方法 如 下 所 示 : 


Body bodyl =arg0.shapel.getBody(); 
Body body2 =arg0.shape2.getBody(); 


最 后 让 物理 世界 World 实例 去 绑 定 监听 器 即 可 : 


world.setContactListener (ContactListener listener); 


7.12.2 “Body 碰撞 筛选 


通过 上 一 小 节 讲 解 的 方法 ， 就 可 以 完成 对 物理 世界 的 碰撞 监听 ,但 是 有 些 情 况 下 ， 我 们 
并 不 想 让 每 个 Body 之 间 都 发 生物 理 碰撞 ， 或 者 说 想 指定 Body 之 间 是 否 能 发 生 碰撞 的 关系 ， 
这 时 我 们 需要 来 熟悉 Box2D 中 的 FilterData 类 。 


1. FilterDate 类 
FilterData 类 一 般 不 直接 使 用 ， 只 需要 设置 此 类 中 的 属性 ， 此 类 的 源码 如 下 : 


public class FilterData { 

public int categoryBits; 

Public int maskBits; 

Public int groupIndex; 

Public void set(FilterData fd) { 
categoryBits = fd.categoryBits; 
maskBits = fd.maskBits; 
groupIndex = fd.groupIndex; 


FilterData 是 Box2D 提供 的 一 个 碰撞 接触 的 数据 过 滤 类 ， 类 的 结构 很 简单 ， 但 是 其 中 有 
的 3 个 属性 格外 的 重要 ， 下 面 对 FilterData 类 的 3 个 属性 进行 说 明 。 

(1) groupIndex 属性 

groupIndex 属性 文 如 其 名 ， 是 个 分 组 下 标 。 所 谓 分 组 ， 其 实 就 是 Box2D 检测 Body 之 间 
是 否 发 生 碰 撞 的 一 个 判定 条 件 。 

例如 ， 物 理 世 界 中 有 两 个 Body， 分 别 为 body1、body2。 假 设 对 两 个 Body 设置 其 属性 
值 : 
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bodyl 的 groupIndex=1, body2 的 groupIndex=1; 


那么 这 两 个 Body 之 间 会 发 生 碰撞 。 
但 是 如 果 这 么 设置 : 


bodyl 的 groupIndex=-1,，body2 的 groupIndex=-1; 


那么 这 两 个 Body 之 间 则 永远 不 会 发 生 碰撞 。 
这 里 的 groupIndex 属性 的 作用 可 以 用 3 点 来 概括 : 


@ 多 个 Body 的 groupIndex 属性 值 为 正 值 (>=0) ，Body 之 间 永 远 能 发 生 碰撞 ; 
ee 多 个 Body 的 groupIndex 属性 值 为 负 值 (<0) ， 同 一 组 ( groupIndex 值 相同 ) 的 Body 
之 间 永 远 不 会 发 生 碰撞 ; 不 同 组 (groupIndex 值 不 相同 ) 的 Body 之 间 会 发 生 碰 撞 ; 
@ 多 个 Body 的 groupIndex 属性 值 各 不 相同 时 ， 都 会 产生 碰撞 ; 如 果 有 相同 组 时 ， 其 判 
定 方法 通过 前 面 两 点 来 进行 判定 。 
使 用 groupIndex 属性 需要 注意 两 点 : 一 是 groupIndex 的 值 不 能 大 于 一 个 字 节 ; 二 是 同一 
个 Body 设置 多 个 groundIndex 的 值 ， 默 认 取 最 后 一 次 设 定 的 值 。 
(2) categoryBits 和 maskBits 属性 
groupIndex 是 最 优先 的 碰撞 检测 ， 除 了 通过 组 进行 筛选 碰撞 之 外 ， 还 可 以 通过 指定 种 类 
来 进行 筛选 碰撞 : 
e@ categoryBits: 设置 碰撞 种 类 ; 
。 maskBits: 指定 碰撞 种 类 。 


假设 有 3 个 Body: body1、body2 和 body3。 其 中 bodyl 的 categoryBits=2，body2 的 
categoryBits=4， 那 么 body3 如 果 想 与 bodyl 和 body2 都 发 生 碰撞 ， 则 body3 的 maskBits 值 应 
该 为 6 (bodyl 和 body2 的 categoryBitks 之 和 ) 。 这 里 需要 注意 : 

e@ categoryBits 属性 值 必须 为 2 的 倍数 ， 否 则 可 能 出 现 判定 失物 ; 

@ 从 官方 提供 的 数据 了 解 到 ， 对 于 groupIndex 分 组 ，Box2D 只 能 同时 支持 16 个 种 类 。 

前 面 为 大 家 讲述 了 FilterData 类 的 3 个 重要 属性 ， 下 面 就 来 讲解 如 何 为 Body 设置 这 几 个 
属性 值 。 设 置 的 方式 有 两 种 : 

@ 在 创建 Body 的 皮肤 时 进行 设置 ， 这 里 举例 创建 圆 形 Body 皮肤 时 的 设置 : 

CircleDef cd = new CircleDef (); 

@ 设置 groupIndex: cd.filter.groupIndex=1; 

@ 设置 categoryBits: cd.filter.categoryBits=1; 

@ 设置 maskBits: cd.filter.maskBits=1 。 


@ 通 过 已 创建 的 Body 进行 设置 ， 这 里 假设 已 经 创建 好 了 一 个 bodyl: 
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@ 设置 groupIndex: 

bodyl.getShapeList() .getFilterData() .groupIndex = 1; 
@ 设置 categoryBits: 

bodyl.getShapeList() .getFilterData() .categoryBits = 1; 
@ 设置 maskBits: 


body1l.getShapeList() .getFilterData() .maskBits = 1; 


下 面 来 看 一 个 创建 多 个 Body 的 范例 ， 并 设置 其 分 组 与 种 类 属性 ， 项 目 对 应 的 源 代 码 为 
“7-12 (Body 碰撞 监听 ) ”。 


// ---- 在 物理 世界 中 添加 两 个 动态 圆 形 Body 

Body bodyl = createCircle(39, 17, 10, false); 

Body body2 = createCircle(30, 47, 10, false); 

// 定义 bodyl 分 组 1 

bodyl.getShapeList() .getFilterData() .groupIndex = 1; 

// 指定 bodyl 碰撞 种 类 为 2 

bodyl.getShapeList() .getFilterData() .maskBits = 2; 

// 定义 body2 分 组 2 

body2 .getShapeList() .getFilterData() .groupIndex = 2; 

// 定义 body2 种 类 为 2 

body2 .getShapeList() .getFilterData() .categoryBits = 2; 

// 添加 屏幕 下 方 添加 多 个 静态 物体 

or (din d= 0 < 5 LF) A 
Body body = createCircle(i * 20, 100, 10, true); 
// 定义 全 部 静态 body 分 组 为 3 
body.getShapeList() .getFilterData() .groupIndex = 3; 
// 定义 全 部 静态 body 种 类 为 4 
body.getShapeList() .getFilterData().categoryBits = 4; 


在 上 面 的 代码 中 ， 省 略 了 Body 的 创建 代码 。 对 代码 进行 分 析 ， 首 先 观 察 到 body1、 
body2 与 所 有 的 静态 body 的 分 组 都 为 正 值 ， 所 以 它们 相互 之 间 肯 定 发 生 碰撞 ;然后 观察 到 
body1 指定 碰撞 的 种 类 值 为 2，body2 设置 了 种 类 为 2， 其 他 静态 body 的 种 类 设置 为 4， 那么 
可 以 得 到 结论 : 


@ bodyl 与 body2 之 间 能 发 生 碰撞 ; 
@ bodyl 与 其 他 静态 body 不 会 发 生 碰撞 ; 
e body2 与 静态 物体 会 发 生 碰撞 。 


运行 项 目 ， 效 果 如 图 7-14 所 示 。 
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图 7-14 Body 之 间 的 碰撞 关系 


2. Body 碰撞 筛选 监听 器 


在 7.12.1 小 节 中 介绍 了 碰撞 监听 器 ， 那 么 在 Box2D 提供 的 碰撞 监听 器 中 还 有 一 个 筛选 监 
听 器 “ContactFilter”。 这 两 个 监听 器 的 作用 都 是 用 于 监听 碰撞 事件 ， 而 且 两 者 的 使 用 方式 都 
相同 ， 使 用 其 接口 、 重 写 其 函数 、 最 后 使 用 物理 世界 绑 定 其 监听 器 。 

使 用 筛选 监听 器 ， 只 需要 重 写 一 个 函数 : 


@Override 
Public boolean shouldCollide (Shape shapel, Shape shape2) { 
return false; 


} 


默认 此 函数 返回 false， 一 旦 我 们 的 物理 世界 绑 定 此 筛选 监听 器 ， 那 么 所 有 的 Body 之 间 
都 将 失去 碰撞 效果 。 

这 里 需要 注意 : 所 有 的 Body 之 间 失 去 碰撞 效果 ， 而 不 是 失去 碰撞 检测 ! 换言之 ， 当 两 
个 Body 发 生 碰撞 时 ， 筛 选 监听 器 仍 会 响应 shouldCollide 函数 ， 但 是 这 两 个 Body 会 相交 ， 没 
有 碰撞 后 可 能 被 弹 开 、 发 生 角 度 偏 移 等 视觉 效果 。 

那么 我 们 可 以 在 筛选 监听 器 的 shouldCollide 函数 中 编写 一 些 处 理 代 码 ， 例 如 在 函数 中 添 
加 如 下 代码 (假设 有 物理 世界 中 存在 两 个 Body， 分 别 为 bodyl 与 body2， 并 且 物 理 世 界 设置 
了 筛选 监听 器 ) : 
@Override 
Public boolean shouldCollide (Shape shapel, Shape shape2) { 

if (shapel.getBody() == bodyl && shape2.getBody() == body2) 


return true; 
return false; 


这 么 处 理 后 ，bodyl 与 body2 发 生 碰 撞 时 就 会 拥有 碰撞 效果 。 碰 撞 筛 选 器 比 碰撞 监听 器 
更 加 具有 扩展 性 ， 可 以 在 碰撞 筛选 器 中 实现 监听 器 的 功能 ， 但 是 由 于 其 自由 度 太 大 ， 一 般 使 
用 碰撞 监听 器 就 足以 满足 处 理 要 求 。 
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3. Body 传感器 


Body 的 传感器 其 实 就 是 Body 皮肤 的 一 个 属性 ， 属 性 名 为 isSensor， 默 认 值 为 false。 设 
置 其 isSensor 属性 的 方式 有 两 种 : 


@ 创建 Body 皮肤 时 设置 isSensor 属性 ; 
e 利用 已 创建 的 Body 去 设置 。 


假设 有 一 个 Body 实例 body1， 设 置 方法 如 下 : 


bodyl.getShapeList().m isSensor=true; 


Body 传感器 的 作用 是 : 一 个 Body 的 传感器 属性 如 果 设 为 真 (true) ， 此 Body 则 不 会 与 
其 他 Body 产生 碰撞 效果 ， 但 是 此 Body 与 其 他 Body 之 间 的 碰撞 也 能 被 监听 器 监听 到 。 

例如 有 一 款 游戏 中 ， 有 一 个 门 Body， 有 一 个 球 Body， 当 小 球 每 次 只 要 从 门 的 一 侧 穿 过 
到 达 另 一 侧 时 ， 就 计数 一 次 ， 当 计数 达到 一 定 的 次 数 以 后 则 判定 游戏 胜利 。 那 么 针对 这 样 一 
款 游戏 ， 首 先 想到 既然 需要 进行 次 数 统计 ， 那 么 一 定 会 对 门 与 小 球 两 个 Body 进行 监听 碰 
撞 ， 但 是 又 不 能 让 两 个 Body 产生 碰撞 效果 ， 因 为 游戏 中 需要 小 球 穿 过 门 ! 这 时 就 可 以 利用 
Body 传感器 属性 来 实现 相应 的 代码 。 

其 实 大 家 也 不 难 想到 ， 类 似 上 述 这 种 情况 ， 即 使 不 使 用 Body 的 传感器 属性 ， 单 单 利用 
Body 的 组 与 种 类 属性 也 能 做 到 。 


7/.13 关 忆 


在 Box2D 中 除了 物体 Body 外 ， 还 使 用 到 关节 Joint。 关 节 的 主要 作用 是 用 来 限制 和 约束 
Body 之 间 的 位 置 、 距 离 、 速 度 、 运 动 轨迹 等 ， 本 节 将 详细 讲解 在 Box2D 中 的 6 种 关节 作用 
和 其 实现 方法 。 


7.13.1 ”距离 关节 


距离 关节 (DistanceJoint) 用 来 限制 两 个 Body 的 质心 距离 永久 保持 不 变 。 
我 们 可 以 在 项 目 中 创建 一 个 距离 关节 ， 项 目 对 应 的 源 代码 为 “7-13-1 (距离 关节 ) ”。 
在 项 目 中 添加 一 个 createDistanceJoint 函数 : 


public DistanceJoint createDistanceJoint() { 
// 创 建 一 个 距离 关节 数据 实例 
DistanceJointDef dje = new DistanceJointDef (); 
// 初始 化 关节 数据 
dje.initialize (body1，body2，bodyl .getWorldCenter ()， 
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body2 .getWorldCenter ()); 
// dje.collideConnected=true; 
// 利 用 世界 通过 传 入 的 距离 关节 数据 创建 一 个 关节 
DistanceJoint dj = (DistanceJoint) world.createJoint (dje); 
return dj; 


上 面 代码 使 用 了 Initialize (Body body1,Body body2,Vec2 anchorl,Vec2 anchor2) 方法 ， 
这 个 方法 的 前 两 个 参数 是 绑 定 在 距离 关节 上 的 两 个 Body 的 实例 ， 后 面 两 个 参数 是 两 个 Body 
在 物理 世界 的 坐标 。 

关节 的 创建 也 与 Body 的 创建 相似 ， 不 能 直接 new， 只 能 通过 物理 世界 world 来 “生产 ” 
出 来 。 创 建 一 个 关节 ， 都 是 利用 World 的 createJoint (JointDef def) 函数 来 创建 ， 这 个 函数 
的 参数 要 求 传 入 关节 的 数据 信息 。World 也 是 根据 传 入 的 这 个 关节 数据 信息 来 决定 应 该 创建 
出 什么 类 型 的 关节 。 

在 关节 数据 的 实例 中 一 般 都 会 用 到 collideConnected 属性 ， 此 属性 表示 绑 定 在 关节 上 的 两 
个 Body 之 间 是 否 可 以 发 生 碰撞 。 

距离 关节 的 作用 一 开始 提 到 过 ， 它 可 以 保持 两 个 Body 的 质心 距离 不 变 ， 那 么 这 个 距离 
就 是 在 距离 关节 数据 进行 初始 化 的 时 候 根 据 两 个 Body 在 物理 世界 的 坐标 而 确定 的 。 

运行 项 目 ， 效 果 如 图 7-15 所 示 。 


于 


图 7-15 ”距离 关节 
关节 Joint 的 常用 方法 和 属性 如 下 所 示 。 


e m_bodyl: 设置 关节 的 bodyl 实例 ; 
m_body2: 设置 关节 的 body2 实例 ; 
dj.getBody10: 获取 关节 的 bodyl 实例 ; 
dj.getBody2(): 获取 关节 的 body2 实例 ; 
getAnchor1(): 获取 关节 的 第 一 个 锚 点 坐标 ; 
getAnchor2(0): 获取 关节 的 第 二 个 锚 点 坐标 。 
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7.13.2 ”旋转 关节 


旋转 关节 (RevoluteJoint) 指 一 个 Body 围绕 另外 一 个 Body 进行 旋转 。 下 面 举 一 个 例子 
来 说 明 如 何 创建 一 个 旋转 关节 ， 示 例 项 目 对 应 的 源 代 码 为 “7-13-2 〈 旋 转 关 节 ) ”。 
在 项 目 中 添加 一 个 createRevoluteJoint 函数 ，Body 创建 的 代码 此 处 省 略 ; 
public RevoluteJoint createRevoluteJoint() { 
// 创 建 一 个 旋转 关节 的 数据 实例 
RevoluteJointDef rjd = new RevoluteJointDef (); 
// 初 始 化 旋转 关节 数据 
rjd.initialize (bodyl, body2, bodyl.getWorldCenter () ) ; 
rjd.maxMotorTorque = 1;// 马达 的 预期 最 大 扭矩 
rjd.motorSpeed =20;// 马 达 最 终 扭矩 
rjd.enableMotor = true;// 启动 马达 
// 利 用 world 创建 一 个 旋转 关节 
RevoluteJoint rj = (RevoluteJoint)world.createJoint (rjd); 
roborn ri 


在 上 面 代码 中 ， 初 始 化 旋转 关节 数据 的 函数 为 Initialize (Body body1,Body body2,Vec2 
anchor) ， 它 的 参数 含义 说 明 如 下 : 


@ 第 一 个 参数 : 做 旋转 运动 的 Body 实例 ; 
e@ 第 二 个 参数 : 旋转 关节 中 的 第 二 个 Body 实例 ; 
e 第 三 个 参数 : 旋转 锚 点 。 


当 旋 转 关 节 的 数据 初始 化 之 后 ， 旋 转 Body 是 不 会 运动 的 ， 因 为 没有 力 的 作用 ， 所 以 需 
要 一 个 “马达 ”来 进行 驱动 Body， 让 Body 开始 做 旋转 运动 。 

“马达 ”也 是 旋转 关节 中 的 数据 ， 所 以 利用 RevoluteJointDef 实例 来 进行 设置 ， 启 动 一 
个 “马达 ”驱动 旋转 Body 进行 旋转 运动 ， 至 少 需要 设置 下 面 三 个 属性 : 

e maxMotorTorque: 马达 的 预期 最 大 扭矩 ; 

e motorSpeed: 马达 最 终 捏 矩 ; 

e@ enableMotor: 启动 马达 。 

马达 预期 最 大 扭矩 指 的 是 Body 在 进行 旋转 运动 开始 的 一 个 扭矩 值 ， 可 以 简单 理解 为 旋 
转速 度 。 马 达 最 终 扭矩 指 的 是 马达 最 终 会 以 一 个 固定 的 转速 来 运动 ， 而 这 个 转速 就 是 取决 最 
终 扭 矩 。 当 两 者 属性 设置 完毕 ， 最 后 启动 马达 即 可 。 

运行 项 目 ， 效 果 如 图 7-16 所 示 。 
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E 


图 7-16 旋转 关节 
在 使 用 旋转 关节 时 需要 注意 以 下 几 点 : 


e 设置 的 “预期 捏 短 ” 如 果 比 “最 终 捏 矩 ” 小， 那么 要 考虑 “预期 捏 矩 ”的 扭矩 力 是 
否 能 克服 重力 使 旋转 Body 运动 ， 如 果 “ 预 期 扭矩 ” 偏 小 则 否则 无 法 正常 旋转 ; 

@ 马达 默认 转速 是 根据 “预期 最 大 扭矩 ”来 决定 的 ; 

e@ 旋转 Body 取决 于 初始 化 旋转 关节 函数 Initialize 的 第 一 个 Body 参数 ; 

@ 旋转 关节 中 默认 逆 时 针 旋 转 ， 可 通过 设置 捏 答 来 设置 旋转 方向 ; 当 扭 矩 为 负数 时 旋转 
Body 进行 顺 时 针 旋 转 ; 

@ 设置 预 扭矩 时 要 注意 不 要 过 小 ， 否 则 当 无 法 抗拒 自身 的 重力 的 话 就 无 法 旋转 。 


这 里 ， 再 说 明 一 下 旋转 关节 的 角度 限制 问题 。 旋 转 关 节 是 一 个 Body 围绕 另外 一 个 Body 
进行 旋转 运动 ， 那 么 除了 设置 预期 扭矩 与 最 终 扭矩 之 外 ， 还 能 限制 旋转 关节 的 旋转 角 。 可 以 
通过 RevoluteJointDef 实例 来 设置 旋转 关节 的 角度 限制 ， 其 方法 如 下 : 


e@ enableLimit: 是 否 启动 关节 限制 ; 
@ lowerAngle: 旋转 关节 角 的 最 小 角度 ; 
e。 upperAngle: 旋转 关节 角 的 最 大 角度 。 


在 Box2D 中 逆 时 针 旋 转 时 ， 旋 转 关 节 角 为 正 ， 顺 时 针 旋 转 时 ， 旋 转 关 节 角 为 负 。 


7.13.3 ”齿轮 关节 


齿轮 关节 (GearJoint) 指 让 两 个 Body 进行 齿轮 咬合 运动 。 上 一 小 节 讲 解 了 如 何 创建 旋 
转 关节 ， 本 小 节 紧 接着 来 讲述 齿轮 关节 是 有 原因 的 ， 因 为 齿轮 关节 是 需要 两 个 旋转 关节 来 创 
建 完成 的 ， 所 以 创建 齿轮 关节 需要 分 两 个 步 又 完成 ， 以 项 目 源 代码 “7-13-3 (此 轮 关 节 ) ” 
为 例 说 明 如 何 创建 齿轮 关节 。 

(1) 创建 两 个 旋转 关节 

创建 两 个 旋转 关节 的 代码 如 下 : 
/ /创建 第 一 个 旋转 关节 


Public RevoluteJoint createRevoluteJoint1() { 
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RevoluteJointDef rjd = new RevoluteJointDef (); 

rjd.initialize (world.getGroundBody () bodyl, 
bodyl.getWorldCenter ()); 

rjd.maxMotorTorque = 20; 

rjd.motorSpeed = 20; 

rjd.enableMotor = true; 

RevoluteJoint rj = (RevoluteJoint) world.createJoint (rjd); 

return rj; 


} 
/ /创建 第 二 个 旋转 关节 
Public RevoluteJoint createRevoluteJoint2() { 
RevoluteJointDef rj = new RevoluteJointDef(); 
rj.initialize (world.getGroundBody(), body2, 
body2.getWorldCenter ()); 
return (RevoluteJoint) world.createJoint (rj); 
| 


这 里 创建 两 个 旋转 关节 分 别 使 用 了 两 个 方法 去 创建 ， 原 因 在 于 : 

在 创建 齿轮 关节 时 ， 需 要 设置 两 个 旋转 关节 ， 那 么 由 于 在 齿轮 关节 中 默认 由 第 一 个 旋转 
关节 带动 第 二 个 旋转 关节 ， 而 第 二 个 齿轮 关节 不 需要 任何 设置 ， 只 需要 初始 化 。 也 就 是 说 此 
轮 关 节 中 一 个 是 “ 自 运动 的 旋转 关节 ”， 另 外 一 个 是 “被 带动 的 旋转 关节 ”， 所 以 两 个 旋转 
关节 的 创建 是 不 太一 样 的 。 

创建 绑 定 在 齿轮 关节 上 的 旋转 关节 需要 注意 以 下 两 点 : 


@ 齿轮 关节 绑 定 的 每 个 旋转 关节 在 创建 时 ， 旋 转 关 节 数 据 初 始 化 时 的 第 一 个 参数 body1 
必须 为 “接地 Body”; 所 谓 “ 接 地 Body”， 其 实 是 World 物理 世界 中 自 带 的 一 个 
Body， 可 以 通过 world.getGroundBody() 函 数 来 得 到 。 

e@ 在 遍历 Body 一 节 中 提 到 ， 通 过 world.getBodyCount() 获 取 的 值 默认 返 回 是 1， 那 么 ， 
由 此 我 们 可 以 猜测 可 能 在 创建 物理 世界 时 ， 就 初始 化 了 一 个 接地 Body。 所 以 即使 没 
有 往 World 里 添加 Body， 通 过 world.getBodyCount() 函 数 总 不 会 返回 0。 


因为 齿轮 关节 默认 从 慢 速 开 始 运动 ， 所 以 即使 创建 旋转 关节 时 设置 它 的 “预期 最 大 扭 
和 矩 ” 小 于 “最 终 扭矩 值 ” 变 得 无 效果 ; 但 是 “预期 最 大 扭矩 ”与 “最 终 扭矩 值 ”为 旋转 关节 
转动 的 必须 条 件 ， 虽 然 在 齿轮 关节 中 没有 效果 但 是 必须 有 其 属性 。 

(2) 创建 齿轮 关节 

创建 齿轮 关节 的 代码 如 下 : 


public GearJoint createGearJoint() { 
// 创 建 齿轮 关节 数据 实例 
GearJointDef gjd = new GearJointDef(); 
// 设 置 齿 轮 关节 的 两 个 Body 
gjd.bodyl bodyl; 
gjd.body2 body2; 
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// 设 置 齿 轮 关节 绑 定 的 两 个 旋转 关节 

gjd.joint1l = rjl; 

gjd. oint2 = 2 

// 设 置 旋转 角度 比 

gjd.ratio = 10; 

// 通 过 world 创建 一 个 齿轮 关节 

GearJoint gj = (GearJoint) world.createJoint (gjd) ; 
return gj; 


齿轮 关节 没有 初始 化 关节 数据 的 方法 ， 而 是 通过 手动 去 设置 Body 与 旋转 关节 完成 。 代 
码 中 的 “ratio=10” 表 示 “ 自 运动 的 旋转 关节 ”转动 十 周 时 ，“ 被 带动 的 旋转 关节 ”正好 旋转 
运行 项 目 ， 效 果 如 图 7-17 所 示 。 


图 7-17 齿轮 关节 


7.13.4 ”滑轮 关节 


滑轮 关节 (PulleyJoint) 指 两 个 Body 绑 定 滑轮 关节 ， 让 两 个 Body 都 沿 着 一 个 世界 锚 点 
进行 滑轮 运动 。 

我 们 用 一 个 范例 来 说 明 如 何 创建 一 个 滑轮 关节 ， 范 例 项 目 对 应 的 源 代 码 为 “7-13-3〈 滑 
轮 关 节 ) ”。 在 项 目 中 添加 一 个 createPulleyJointDef 函数 ，Body 创建 的 代码 此 处 省 略 : 


Public PulleyJoint createPulleyJointDef() { 
// 创 建 滑轮 关节 数据 实例 
PulleyJointDef pjd = new PulleyJointDef(); 
Vec2 gal = new Vec2(anchorlx/ RATE,anchorly/ RATE); 
Vec2 ga2 = new Vec2 (anchor2x/ RATE,anchor2y/ RATE); 
// 初 始 化 滑轮 关节 数据 
//body， 两 个 滑轮 的 锚 点 ， 两 个 body 的 锚 点 ， 比 例 系数 
pjd.initialize (bodyl, body2, gal,ga2, 
bodyl .getWorldCenter ()， 
body2 .getWorldCenter(), 1f); 
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PulleyJoint pj = (PulleyJoint) world.createJoint (pjd); 
return pj; 


createPulleyJointDef 函数 的 初始 化 方法 为 Initialize (Body bodyl,Body body2, Vec2 
gal,Vec2 ga2,Vec2 anchorl,Vec2 anchor2,floatr) ， 其 参数 说 明 如 下 : 


第 一 个 参数 : 第 一 个 Body 实例 ; 
第 二 个 参数 : 第 二 个 Body 实例 ; 
第 三 个 参数 : 第 一 个 滑轮 锚 点 ; 
第 四 个 参数 : 第 二 个 滑轮 锚 点 ; 
第 五 个 参数 : 拉 伸 长 度 的 比例 。 


项 目 运行 效果 如 图 7-18 所 示 。 


图 7-18 滑轮 关节 


在 滑轮 关节 中 ， 两 个 Body 谁 会 向 上 运动 ， 谁 会 向 下 运动 ， 这 完全 取决 于 滑轮 关节 上 的 
两 个 Body 中 每 个 Body 的 质量 大 小 ， 谁 重 谁 肯 定向 下 运动 。 

现在 回头 解释 Initialize 函数 的 第 五 个 参数 拉 伸 长 度 的 比例 。 假 设 当前 创建 了 一 个 如 图 7- 
19 所 示 的 滑轮 关节 。 

在 图 7-19 中 ，Body2 质量 大 于 Body1 的 质量 ， 所 以 Bodyl 向 上 运动 ，Body2 向 下 运动 。 


@ 如 果 设 置 此 滑轮 关节 的 长 度 比 为 1， 那么 当 length1=5 时 ，length2=21; 
@ 如 果 设 置 此 滑轮 关节 的 长 度 比 为 >， 那么 当 length1=5 时 ，length2=26; 
@ 如果 设置 此 滑轮 关节 的 长 度 比 为 3， 那 么 当 length1=5 时 ，length2=31。 


由 此 ， 可 以 更 形象 地 看 出 “ 拉 伸 长 度 的 比例 ”所 表示 的 具体 含义 了 ，“ 拉 伸 长 度 的 比 
例 ” 就 是 表示 两 个 滑轮 到 两 个 Body 之 间 的 两 个 长 度 会 按照 此 比例 关系 成 比例 增长 。 
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length1I=10 
length2 =16 


假设 : Body2 质 量 大 于 Bodyl 
次 轮 1 到 Body1 的 距离 为 10 
次 轮 2 到 Body2 的 距离 为 16 


图 7-19 滑轮 关节 长 度 比 演示 图 
滑轮 关节 的 其 他 属性 还 包括 : 


e maxLengthl: 设置 滑轮 关节 的 第 一 条 距离 拉 伸 的 最 大 长 度 ; 
ee pd.maxLength2: 设置 滑轮 关节 的 第 二 条 距离 拉 伸 的 最 大 长 度 ; 
e ratio: 设置 滑轮 关节 的 拉 伸 长 度 比例 。 


在 使 用 滑轮 关节 时 ， 唯 一 要 提醒 的 一 点 是 : 设置 滑轮 拉 伸 的 长 度 比例 (ratio) ， 一 定 要 
在 滑轮 关节 数据 初始 化 之 后 设置 ， 和 否则 此 比例 肯定 会 被 滑轮 关节 数据 初始 化 时 的 最 后 一 个 函 
数 〈 设 置 拉 伸 长 度 比例 ) 重新 设置 覆盖 掉 。 


7.13.5 ”移动 关节 


移动 关节 〈PrismaticJoint) 起 两 个 作用 : 一 个 作用 是 让 物体 沿 着 世界 锚 点 进行 移动 ， 另 
外 一 个 作用 就 是 让 绑 定 在 移动 关节 上 的 两 个 Body 进行 相同 的 动作 。 

首先 实现 通过 移动 关节 让 Body 移动 ， 项 目 对 应 的 源 代码 为 “7-13-7-1 (通过 移动 关节 移 
动 Body) ”。 

添加 一 个 createPrismaticJointMove 函数 ，bodyl 的 创建 代码 此 处 省 略 : 


Public PrismaticJoint createPrismaticJointMove () { 
// 创 建 移动 关节 数据 实例 
PrismaticJointDef pjd = new PrismaticJointDef (); 
// 初 始 化 移动 关节 数据 
pjd.initialize (world.getGroundBody (), bodyl, 
bodyl.getWorldCenter(), new Vec2(1, 0)); 
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// 预 设 马达 的 最 大 力 

pjd.maxMotorForce = 10; 

// 马 达 的 最 终 力 

pjd.motorSpeed = 10; 

// 启 动 马达 

pjd.enableMotor = true; 

// 设 置 位 移 最 小 偏 移 值 
pjd.lowerTranslation = -80.0f / RATE; 
// 设 置 位 移 最 大 偏 移 值 
pjd.upperTranslation = 80.0f / RATE; 
// 启 动 限制 

pid.enableLimit = true; 

// 通 过 world 创建 一 个 移动 关 
PrismaticJoint pj = (PrismaticJoint) world.createJoint (pjd); 
return pj; 


移动 关节 数据 初始 化 函数 为 initialize (Body groundBody, Body body1,Vec2 anchor , Vec2 
axis) ， 其 参数 说 明 如 下 : 

e 第 一 个 参数 : 传 入 接地 Body; 

e@ 第 二 个 参数 : 移动 Body 实例 ; 

. 

@ 第 四 个 参数 : 物理 世界 坐标 轴 。 
移动 关节 Body 的 移动 方向 取决 于 “马达 的 最 终 力 (motorSpeed) ”的 值 : 
(1) 当 motorSpeed>0 时 ， 物 理 世界 坐标 轴 (axis) 的 设置 含义 如 下 : 


new Vec2(1,0) 表示 Body 沿 着 义 轴 正方 向 进行 移动 ; 
new Vec2 (-1,0) 表示 Body 沿 着 X 轴 反 方向 进行 移动 ; 
new Vec2 (0,1) 表示 Body 沿 着 Y 轴 正 方向 进行 移动 ; 
new Vec2 (0,-1) 表示 Body 沿 着 Y 轴 反 方向 进行 移动 。 


(2) 当 motorSpeed<0 时 ， 物 理 世界 坐标 轴 (axis) 的 设置 含义 如 下 : 


new Vec2 (1,0) 表示 Body 沿 着 义 轴 反方 向 进行 移动 ; 

new Vec2 (-1,0) 表示 Body 沿 着 X 轴 正 方向 进行 移动 ; 

new Vec2 (0,1) 表示 Body 沿 着 立轴 反方 向 进行 移动 ; 

new Vec2 (0,-1) 表示 Body 沿 着 Y 轴 正 方向 进行 移动 。 

在 使 用 移动 关节 时 需要 注意 如 下 两 点 : 

日 在 移动 关节 中 “ 预 设 马 达 的 最 大 力 ”无 效 ， 默 认 从 0 缓 动 ; 
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。 绑 定 在 移动 关节 上 的 Body 在 移动 过 程 中 不 会 发 生 角 度 的 偏转 。 


项 目 运行 效果 如 图 7-20 所 示 。 


图 7-20 移动 关节 -移动 Body 


下 面 来 看 一 下 如 何 通过 移动 关节 实现 让 两 个 Body 进行 相同 的 动作 ， 项 目 对 应 的 源 代码 
为 “7-13-7-2( 通 过 移动 关节 绑 定 两 个 Body 动作 ) ”。 
添加 一 个 createPrismaticJoint 函数 ， 此 处 省 略 两 个 Body 的 创建 代码 : 


/ /创建 移动 关节 
Public PrismaticJoint createPrismaticJoint() { 
// 创 建 移动 关节 数据 实例 
PrismaticJointDef pjd = new PrismaticJointDef (); 
// 预 设 马达 的 最 大 力 
pid.maxMotorForce = 10; 
// 马 达 的 最 终 力 
pjd.motorSpeed = 10; 
// 启 动 马达 
pjd.enableMotor = true; 
// 设 置 位 移 最 小 偏 移 值 
pjd.lowerTranslation = -3.0f / RATE; 
// 设 置 位 移 最 大 偏 移 值 
pjid.upperTranslation = 3.0f / RATE; 
// 启 动 限制 
pjd.enableLimit = true; 
// 初 始 化 移动 关节 数据 
pjd.initialize (bodyl, body2, bodyl.getWorldCenter(), 
new Vec2(0, 1)); 
// 通 过 world 创建 一 个 移动 关节 
PrismaticJoint pj = (PrismaticJoint) world.createJoint (pjd); 
return pj; 


创建 方式 比较 简单 ， 唯 一 需要 注意 的 就 是 移动 关节 数据 初始 化 函数 initialize， 它 的 第 一 
个 参数 与 第 二 个 参数 分 别 是 Body 实例 ， 而 不 使 用 接地 body。 
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项 目 运行 效果 如 图 7-21 所 示 。 


7-21 移动 关节 - 绑 定 Body 动作 
通过 图 7-21 可 以 很 清晰 的 看 到 ， 移 动 关节 绑 定 的 两 个 Body， 一 个 Body 发 生 旋 转 ， 另 外 
-个 则 也 会 随 之 做 出 相同 的 旋转 动作 。 利 用 移动 关节 的 这 些 特点 ， 然 后 加 上 旋转 关节 提供 驱 
动力 可 以 制作 一 个 运动 中 的 小 车 。 


7.13.6 ”鼠标 关节 


鼠标 关节 (MouseJoint) 指 利用 鼠标 提供 力 的 作用 ， 拖 搜 Body，Body 朝向 鼠标 点 击 的 位 
置 进行 移动 ， 其 效果 如 同 在 Body 与 鼠标 之 间 绑 定 了 一 个 橡皮 筋 。 

假设 物理 世界 中 存在 一 个 Body， 然 后 点 击 屏幕 产生 一 个 鼠标 点 ， 那 么 Body 会 朝 着 如 图 
7-22 所 示 的 箭头 指向 的 方向 运动 。 


eh 


息 标 点 击 
屏幕 的 位 置 


图 7-22 Body 向 鼠标 位 置 移 动 


下 面 来 创建 鼠标 关节 ， 并 通过 点 击 屏幕 产生 鼠标 点 以 拖 搜 Body， 项 目 对 应 的 源 代码 为 
“7-13-6〈 鼠 标 关节 - 拖 搜 Body) ”。 首 先 创 建 鼠标 关节 (bodyl 的 创建 此 处 省 略 ) ， 在 项 目 
中 添加 一 个 createMouseJoint 函数 : 

Public MouseJoint createMouseJoint() { 


MouseJointDef mjd = new MouseJointDef(); 


// 设 置 鼠 标 关节 的 第 一 个 Body 实例 (默认 使 用 接地 Body) 
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mjd.bodyl = world.getGroundBody () ; 

// 设 置 鼠标 关节 的 第 二 个 Body 实例 (被 拖 搜 的 Body) 
mjd.body2 = bodyl; 

// 设 置 目标 点 的 X 坐标 

mjd.target.x = bodyl.getPosition() .x; 

// 设 置 目标 点 的 Y 坐标 

mjd.target.y = bodyl.getPosition().y; 

// bodyl.allowSleeping (false) ;// 设 置 bodyl 永 不 休眠 
// 设置 鼠标 关节 的 目标 位 置 

mjd.maxForce = 100;// 拉力 


// 由 World 来 创建 鼠标 关节 
MouseJoint mj = (MouseJoint) world.createJoint (mjd); 
return mj; 


到 这 里 代码 只 是 创建 了 一 个 鼠标 关节 ， 并 且 将 Body 绑 定 在 了 鼠标 关节 中 。 接 下 来 需要 
重 写 触 屏 函 数 ， 添 加 处 理 代码 : 
@Override 
Public boolean onTouchEvent (MotionEvent event) { 
// 唤 醒 Body1l 
bodyl .wakeUp (); 


mouseJoint.m target.set (event .getX() / RATE, event.getY() / RATE); 
return true; 


在 上 面 代码 中 ， 首 先 唤醒 body1， 因 为 对 bodyl 不 产生 操作 时 ，body1 静止 后 会 默认 进入 
休眠 状态 ， 而 且 一 旦 当 bodyl 进入 休眠 ， 就 无 法 响应 鼠标 关节 的 事件 了 ， 接 下 来 设置 鼠标 关 
节 的 目标 点 ， 使 之 绑 定 在 鼠标 关节 的 Body 向 目标 点 运动 。 

运行 项 目 效果 如 图 7-23 所 示 。 

从 图 7-23 可 看 出 ， 鼠 标 关节 往 目标 点 进行 移动 时 ， 会 有 一 定 的 弹性 ， 然 后 最 终 会 趋向 目 
标点 并 停止 运动 ， 这 时 ， 其 弹性 则 可 以 通过 鼠标 关节 来 设置 。 

弹性 度 属性 名 为 m_gamma， 此 属性 无 法 利用 鼠标 关节 数据 (MouseJointDef) 来 设置 ， 只 
能 通过 鼠标 关节 实例 (MouseJoint) 来 对 其 进行 设置 ， 方 法 如 下 。 


mouseJoint.m gamma = 1.0f; 
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图 7-23 鼠标 关节 


通过 AABB 获取 Body 


AABB 本 身 指 的 是 一 个 区 域 范围 ， 通 过 AABB 的 实例 调用 lowerBound 与 upperBound 函 
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数 来 设置 区 域 范围 的 大 小 。 
在 创建 World 物理 世界 时 ， 传 入 一 个 AABB 区 域 范围 来 表示 物理 世界 的 范围 。 当 然 它 的 
作用 不 仅 如 此 ; 在 World 类 中 ， 封 装 了 query 的 方法 ， 其 参数 中 需 传 入 一 个 AABB 实例 : 


query (AABB aabb,int maxCount) 
日 第 一 个 参数 : AABB 实例 ， 区 域 范围 ; 
。 第 二 个 参数 : 最 大 重合 数 。 


query 方法 的 作用 是 返回 在 物理 世界 的 AABB 区 域 范围 内 存在 的 所 有 Shape 实例 ， 返 回 
的 最 大 值 不 可 超过 最 大 重合 数 。 

Shape 是 皮肤 的 父 类 ， 它 的 子 类 有 CircleShape 与 PolygonShape， 而 且 子 类 又 派生 了 
CircleDef 与 PolygonDef 类 。 

我 们 封装 了 一 个 getBodies 函数 ， 示 例 项 目 对 应 的 源 代码 为 “7-14 (AABB 获取 Body) ”。 


public Shape[] getBodies (float x, float y, float range, int maxCount) { 
AABB aabbBody = new AABB(); 
aabbBody.lowerBound.set ((x - range) / RATE, (y - range) / RATE); 
aabbBody.upperBound.set ((x + range) / RATE, (y + range) / RATE); 
Shape[] shapes = world.query(aabbBody, maxCount); 
// 遍历 此 aabb 范围 中 的 body， 筛 选 操作 
for (int i = 0; i < shapes.length; i++) { 
if (shapes[i] .getBody() .isStatic()) { 
// .…… .判定 物体 是 否 为 静态 
} 
if (shapes[i] .getBody().isSleeping()) { 
// .… .判定 物体 是 否 进入 休眠 
} 
!! 
return shapes; 


在 上 面 代码 实现 的 getBodies 函数 中 : 


第 一 个 参数 : AABB 中 心 点 义 坐标 ; 

第 二 个 参数 : AABB 中 心 点 Y 坐标 ; 

第 三 个 参数 : AABB 的 范围 ; 

第 四 个 参数 : 返回 AABB 区 域 中 Shape 最 大 重合 值 。 


获取 AABB 区 域 Body 的 步骤 如 下 : 


首先 创建 一 个 AABB 范围 。 
通过 world.query0 函 数 传 入 创建 的 AABB 实例 ， 并 且 设 置 最 大 重 又 数值， 得 到 所 有 
Shape 数组 。 
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有 些 情况 我 们 并 不 想得到 这 个 AABB 范围 内 的 所 有 Body， 那 么 可 以 通过 遍历 
Shape 取出 所 有 Body， 利 用 筛选 条 件 对 其 Shape 数组 进行 筛选 ; 在 此 封装 的 
getBodies 函数 中 筛选 的 条 件 有 两 个 : 
® 判定 物体 是 否 为 静态 物体 ; 

@ 物体 是 否 进入 休眠 ; 
在 本 示例 项 目 中 ， 编 者 只 是 编写 了 判定 条 件 的 定义 ， 并 没有 编写 筛选 出 的 物体 的 操作 ， 

大 家 可 以 根据 需要 写 出 适合 的 筛选 条 件 ， 并 进行 处 理 。 

项 目 运 行 效果 如 图 7-24 所 示 。 


与 指定 AABB 范 围 相交 了 2 个 Body ! 


es 


全 表示 证 的 AABB 区 域 
人 〇 存在 物体 世界 中 的 Body 


图 7-24 通过 AABB 获取 其 范围 所 有 Body 


EE a 


/ .| ”物体 与 关节 的 销毁 


前 面 章节 讲解 了 物体 Body 与 关节 Joint 的 创建 ， 但 是 没有 讲解 如 何 销毁 物体 与 关节 ; 这 
里 单独 用 一 小 节 来 强调 销毁 过 程 ， 也 是 为 了 提醒 大 家 销毁 操作 的 重要 性 。 
想 要 摧毁 一 个 Body 或 者 Joint， 只 要 使 用 World 类 调用 其 destory 函数 即 可 ， 方 法 如 下 : 


@ 摊 毁 物体 : world.destroyBody ( Body body ) ; 


e@ 挫 毁 关节 : world.destroyJoint (Joint joint ) 。 


代码 很 简单 ， 但 是 千 万 不 要 认为 摧毁 一 个 物体 和 关节 就 这 么 简单 。 假 如 在 World 中 存在 
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一 个 物体 Body， 如 果 需 要 在 按键 事件 中 删除 这 个 Body， 那 么 一 般 做 法 肯定 是 在 按键 事件 中 
直接 调用 “world.destroyBody (Body body) ;” 语 句 ， 将 需要 删除 的 Body 传 入 此 函数 ， 其 实 
这 种 做 法 是 错误 的 ! 出 现 问题 的 直接 原因 就 是 因为 物理 世界 在 模拟 时 出 现 异 常 。 

大 家 都 知道 world.step0 函 数 是 World 物理 世界 进行 模拟 的 函数 ， 而 且 会 将 此 函数 一 直 放 
在 线程 中 不 断 执 行 ， 让 物理 世界 去 不 断 地 模拟 。 

也 正 是 因为 此 函数 所 起 的 作用 ， 使 得 删除 一 个 Body 或 者 删除 一 个 Joint 不 当 会 造成 物理 
世界 模拟 出 现 问题 ， 抛 出 异常 异常 的 起 因 就 是 因为 物理 世界 正在 进行 模拟 ， 突 然 其 中 的 
Body 被 摧毁 ， 造 成 这 个 Body 所 有 的 引用 地 方 都 成 了 时 指针 。 

解决 方案 是 : 不 管 在 程序 的 任何 位 置 打 算 摧毁 一 个 物体 Body 或 者 关节 Joint， 其 正确 的 
方法 是 应 该 先 将 其 存 入 一 个 容器 中 ， 然 后 在 世界 模拟 完成 之 后 ， 遍 历 容 器 ， 对 容器 中 的 Body 
或 Joint 进行 摧毁 操作 。 也 就 是 说 将 摧毁 Body 或 者 摧毁 Joint 的 操作 放 在 世界 完成 模拟 之 后 ， 
对 应 摧毁 的 代码 写 在 world.step0) 函 数 之 后 。 


/ .1O 本章 小 结 


本 章 主要 讲解 了 用 于 2D 游戏 开发 的 物理 引擎 一 一 JBox2D 的 使 用 方法 ， 内 容 包括 物理 世 
界 、 和 矩形 物体 、 多 边 形 物 体 、 圆 形 物体 、 关 节 、 区 域 范围 等 对 象 的 创建 、 使 用 和 销毁 方法 。 
在 一 章 将 讲述 两 个 游戏 实例 说 明 如 何 使 用 JBox2D 进行 游戏 开发 。 
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从 本 章节 可 以 学 习 到 : 
学 迷宫 小 球 游戏 实战 
学“ 堆 房子 游戏 实战 
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昌 .] 迷宫 小 球 游戏 实战 


首先 我 们 看 一 下 迷宫 小 球 游戏 项 目的 截图 ， 游 戏 主 界面 与 帮助 界面 如 图 8-1 所 示 。 游 戏 
界面 与 游戏 暂停 界面 如 图 8-2 所 示 。 


图 8-2 游戏 界面 与 游戏 暂停 界面 
游戏 胜利 界面 与 失败 界面 如 图 8-3 所 示 。 
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败 ; 
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图 8-3 游戏 界面 胜利 与 失败 界面 
迷宫 小 球 游戏 项 目 简易 流程 如 图 8-4 所 示 。 


游戏 主 界面 


4 


游戏 帮助 。 ，。， 开始 游戏 " 2 


人 


胜利 界面 * 区 二 本 
重 轩 游戏 ， 重 新 游戏 主 菜 单 。 主 菜单 + 重新 游戏 ， 


本 继续 游戏 。 重新 游戏 主 菜单 |， ;返回 游戏 主 荣 单 


重 二 游戏 
8-4 ”迷宫 小 球 游戏 项 目 简易 流程 


迷宫 小 球 游戏 玩法 是 : 上 下 左右 操作 小 球 移动 ， 小 球 碰 触 “黑色 圆 形 区 域 ”判定 游戏 失 
小 球 碰 触 “红色 区 域 ” 判 定 游戏 胜利 。 
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下 面 我 们 对 这 个 游戏 项 目 进行 分 析 。 游 戏 本 身 没 有 难度 ， 由 几 个 简单 的 界面 和 一 些 按钮 
组 成 ， 主 要 操作 是 小 球 Body 的 移动 。 小 球 的 移动 其 实 可 以 通过 改变 物理 世界 的 重力 方向 进 
行 操控 ， 只 要 想到 这 一 点 ， 游 戏 基 本 就 成 功 一 半 了 。 

其 实 此 款 游 戏 可 以 结合 Android 手机 的 重力 感应 功能 来 做 ， 让 玩家 通过 转动 手机 屏幕 来 
操控 小 球 移动 ， 这 样 会 让 整个 游戏 增色 很 多 。 但 这 里 ， 作 者 没有 结合 重力 感应 来 做 的 原因 有 
两 点 : 

。 便于 演示 与 讲解 ， 因 为 此 游戏 实例 重点 在 于 讲解 Box2D 部 分 为 主 ; 

@ 照顾 还 没有 真 机 的 开发 者 ， 因 为 模拟 器 无 法 模拟 手机 的 重力 感应 。 

首先 新 建 项 目 “BallGame”， 如 图 8-5 所 示 ， 然 后 将 Jbox2d 引擎 的 JAR 包 添 加 到 项 目 
中 ， 项 目 对 应 的 源 代码 为 “8-1 (迷宫 小 球 ) ”。 

New Android Projecd Re 


New Android Project Ee 
Creates a new Android Project resource. 1 


Project name: BallGame 


Contents 

© Create new project in workspace 

© Create project from existing source 
团 Use defauk location 


tion: | G/Book/workspace/BallGame Browse. 
© Create project from existing sample 


Samples; ApiDemos 


Build Target 
Target Name Vendor Platform 。 APIL.。 
园 Android 15 Android Open Source Project 15 3 
加 Google Apis Google Inc. 15 3 
国 Android 16 Android Open Source Project 16 4 
加 Google Apts Google Inc. 16 4 


Standard Android platform 1.6 
Properties 

Application name: BallGame 
Package name: com.bg 
Create Activity: = MainActivity 
Min SDK Version: 


Em 


@ < Back Next > Einish Cancel 
8-5 新 建 项 目 “BallGame” 


模拟 器 的 配置 如 图 8-6 所 示 : 
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AVD details 


Name: android16 
Path: C:\Users\Himi\.android\avd\android16.avd 
Target Android 1.6 (ApIlevel 4) 
Skin: HVGA 
SD Card: 20M 


hw.sdCard: yes 
hwilcd.density: 160 
vm.heapSize: 24 


图 8-6 ”模拟 器 的 配置 


在 新 建 项 目 中 添加 资源 文件 ， 如 图 8-7 所 示 : 


4 GB drawable-mdpi 


序列 | 图 片 说 明 图 片 名 称 图 片 缩 略 图 序列 | ”图 片 说 明 图 片 名 称 图 片 缩 略 图 
1 | je 当 虹 | 而 game bgpng wl 12. | 游戏 暂停 背景 | 品 smallbg.png 加 
2.， | 主 菜单 背景 | 加 menu_bg.png 目 13。 | 游戏 失败 背景 二 gamelost.png 图 
| wom | 画 haptepna 留 
4. | 障碍 物 ( 横 ) | 加 sh.png 一 国 ss.png 
5. 边界 ( 异 ) | 二 h.png 一 圆 :png 
6.。 | 失败 物体 | 辆 lostbody png © 17. | ”胜利 物体 | 国 winbody.png © 
7. | 主角 小 球 | 国 | ball.png © 18. | ”应 用 图 标 “| 之 | icon.png © 
8。 | 选 硕 Menu| 加 menu_menupng| 二 于 | 19. | RHelp | 国 menuhelp.png cle 
9. | 选项 Play | 加 menu_play.png =Pjay 20，| 选 需 Resume | 司 menu_resume.png kesuia 
10。 | 选 硕 Back | 加 menu_backpng East 21 | 选项 Replay | 到 menu_replay.png Replag 
11 | 选项 Exit | 加 menu_exit.png 

8-7 在 新 建 项 目 中 添加 的 资源 文件 
修改 主 类 MainActivity: 
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public class MainActivity extends Activity { 
// 声 明 一 个 主 类 (便于 使 用 ) 
public static MainActivity main; 
@Override 
Public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
// 实 例 本 类 
main = this; 
// 设 置 全 屏 
getWindow () .setFlags (WindowManager .LayoutParams .FLAG FULLSCREEN, 
WindowManager .LayoutParams. FLAG FULLSCREEN); 
// 去 除 应 用 程序 标题 
this .requestWindowFeature (Window. FEATURE NO_ TITLE); 
// 设 置 竖 屏 
setRequestedOrientation (ActivityInfo.SCREEN ORIENTATION PORTRAIT); 
// 显 示 自 定义 MySurfaceView 实例 加 
setContentView (new MySurfaceView (this)); 


人 

// 添 加 一 个 程序 退出 方法 

Public void exit() { 
// 退 出 应 用 程序 
System.exzit(0) 


添加 自 定义 的 MySurfaceView 类 ， 游 戏 使 用 SurfaceView 框架 ， 并 且 创建 Box2D 物理 世 
界 。 


Public class MySurfaceView extends SurfaceView implements Callback, 
Runnable { 

Private Thread th; 

Private SurfaceHolder sfh; 

Private Canvas canvas; 

Private Paint paint; 

Private boolean flag; 

// ---- 添 加 一 个 物理 世界 ---->> 

// 屏幕 映射 到 现实 世界 的 比例 30px: lm; 

Private final float RATE = 30; 

// 声明 一 个 物理 世界 对 象 

Private World world; 

// 声明 一 个 物理 世界 的 范围 对 象 

Private AABB aabb; 

// 声明 一 个 重力 向 量 对 象 

Private Vec2 gravity; 

// 物理 世界 模拟 的 的 频率 

Private float timeStep = 1f / 60f; 
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// 和 迭代 值 ， 迭 代 越 大 模拟 越 精确 ， 但 性 能 越 低 
Private int iterations = 10; 
Pub1lic MySurfaceView (Context context) { 
super (context); 
// 保 持 屏幕 常 亮 
this .setKeepScreenOn (true) ; 
// 获 取 句 柄 实例 
sfh = this.getHolder (); 
// 添 加 本 类 回调 函数 
sfh.addCallback (this); 
// 实 例 画 笔 
paint = new Paint(); 
// 设 置 画 笔 无 锯齿 
paint.setAntiAlias (true) 
// 设 置 画 笔 样式 为 空心 
paint.setStyle (Style.STROKE); 
// 设 置 按键 焦点 
this.setFocusable (true); 
/7 设置 触 屏 焦 点 
this.setFocusableInTouchMode (true); 
// -- 添 加 一 个 物理 世界 --->> 
// 实例 化 物理 世界 的 范围 对 象 
aabb = new AABB () 
// 实例 化 物理 世界 重力 向 量 对 象 
gravity = new Vec2 (0，10) 
// 设置 物理 世界 范围 的 左上 角 坐标 
aabb .1owerBound.set(-100，-100) ; 
// 设置 物理 世界 范围 的 右 下 角 坐 标 
aabb .upperBound.set (100, 100); 
// 实例 化 物理 世界 对 象 
world = new World(aabb, gravity, true); 
3. 
Public void surfaceCreated(SurfaceHolder holder) 
// 线 程 循环 标识 位 
flag = true; 
// 线 程 实例 化 
th = new Thread (this); 
// 启 动 线程 
th.start (); 
. 
Public void myDraw() { 


人 
// 获 取 画 布 
canvas = sfh.lockCanvas(); 
// 黑 色 刷 屏 


canvas .drawColor (Color .BLACK); 
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} catch (Exception e) { 


Log.e("Himi", "myDraw is Error!"); 
} finally { 
if (canvas != null) 
sfh.unlockCanvasAndPost (canvas); 


} 
/** 
* 触 屏 按键 事件 处 理 
人 
QOverride 
Public boolean onTouchEvent (MotionEvent event) { 
return true; 
} 
/** 
* 实体 键盘 按键 处 理 
A 
QOverride 
Public boolean onKeyDown (int keyCode, KeyEvent event) { 
return super.onKeyDown (keyCode, event); 
/** 
* 逻 辑 处 理 
ob 
public void Logic() { 
// -开始 模拟 物理 世界 --->> 
world.step (timeStep，iterations);// 物理 世界 进行 模拟 
b 
Public void run() { 
while (flag) { 
myDraw (); 
Logic(); 
try { 
Thread. sleep((long) timeStep * 1000); 
} catch (Exception ex) { 
Log.e("Himi", "Thread is Error!"); 


4 
public void surfaceChanged(SurfaceHolder holder, int format, int 
width, int height) { 
} 
Public void surfaceDestroyed(SurfaceHolder holder) { 
flag = false; 
» 
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从 8.1 节 的 项 目 截图 中 ， 可 以 看 出 游戏 使 用 了 很 多 菜单 选项 ， 所 以 需要 封装 一 个 菜单 先 
项 类 。 

新 建 一 个 按钮 类 HButton。 按 钮 应 该 拥有 “坐标 ”与 “ 宽 高 ”属性 ，“ 绘 制 函数 ”以 及 
“是 否 被 点 击 函 数 ”。 通 过 项 目 截图 可 看 出 每 个 按钮 都 显示 个 图 片 ， 那 么 按钮 还 应 该 有 个 
“图 片 ”的 基本 属性 。 按 钮 类 Hbutton 代码 如 下 : 


public class HButton { 
// 按 钮 xy 坐标 与 宽 高 
Private int x, y, w h; 
// 按 钮 资源 图 片 
private Bitmap bmp; 
/** 
* 按钮 构造 函数 
* @param bmp 按钮 图 片 资源 
* @param x 按钮 xX 坐标 
* @param y 按钮 并 坐 标 
外 
Public HButton (Bitmap bmp, int x, int y) { 
this.x = x; 


this.y = y; 
this.bmp = bmp; 
this.w = bmp.getWidth(); 
this.h = bmp.getHeight (); 
/** 
* 绘制 按钮 


* @param canvas 画布 实例 
* @param paint 画笔 实例 
od 
Public void draw (Canvas canvas, Paint paint) { 
canvas.drawBitmap (bmp, x, y, paint); 
|: 
/** 
* 判定 按钮 是 否 被 点 击 
* @param event 触 屏 事件 参数 
7 
Public boolean isPressed(MotionEvent event) { 
// 判 定 用 户 是 否 点 击 屏幕 
if (event .getRAction() 一 MotionEvent.ACTION DOWN) { 
// 通 过 按钮 坐标 宽 高 与 触 屏 的 坐标 进行 判定 按钮 是 耕 被 点 击 
if (event.getX() <= x + w && event.getX() >= x) { 
if (event.getY() <=y + h && event.getY() >= y) { 
return true; 
J} 
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} 
// 没 有 点 击 返 回 false 


return false; 


} 

// 获 取 按 钮 的 宽 

public int getw() { 
return w; 


} 

// 获 取 按 钮 的 高 

public int getH() { 
return h; 


. 

// 获 取 按钮 的 X 坐标 

Public int getX() { 
return x; 


i 

// 设 置 按钮 的 X 坐标 

Public void setx(int x) { 
this.x = x; 


i 

// 获 取 按 钮 的 Y 坐标 

Public int getY() { 
return y; 


// 设 置 按钮 的 Y 坐标 

Public void setY(int y) { 
this.y = Y7 

上 


因为 这 是 个 Box2D 物理 游戏 ， 所 以 Body 的 种 类 从 项 目 效果 图 中 明显 看 出 有 两 种 ， 一 种 
圆 形 Body， 一 种 矩形 Body。 为 了 便于 Body 与 图 形 传递 运动 数据 ， 我 们 应 该 对 应 设计 两 个 
类 ， 一 个 Circle 类 ， 一 个 Rect 类 。 

首先 创建 一 个 圆 形 类 MyCircle: 


Public class MyCircle { 
// 圆 形 的 宽 高 与 半径 
float x yr rr angles 
// 圆 形 Body 图 片 资源 
Private Bitmap bmp; 
/**# 
* 圆 形 图 片 构造 函数 
* eparam bmp 资源 图 片 
* @param x 圆 形 图 形 X 坐标 
* @param y 圆 形 图 形 Y 坐标 
* @param r 圆 形 图 形 半径 
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oad 
public MyCircle(Bitmap bmp, float x, float y, float r) 
this.bmp = bmp; 
this-x = x 
this.y = y; 
this.r b 


Ul 


. 

/** 

* 圆 形 图 形 绘制 函数 

* @param canvas 画布 实例 

* @param paint 画笔 实例 

区 

Public void drawArc(Canvas canvas, Paint paint) { 
canvas .save (); 
Canvas.rotate(angle, x + r, y+ r); 
canvas .drawBitmap (bmp, x, y, paint); 
canvas.restore(); 


} 

// 设置 圆 形 图 形 的 X 坐标 

Public void setX (float x) { 
this.x = x; 


// 设 置 圆 形 图 形 的 Y 坐标 
public void setY(float Y) { 
this.y = Y7 


// 设 置 圆 形 图 形 的 角度 

Public void setAngle (float angle) { 
this.angle = angle; 

} 


// 获得 圆 形 图 形 的 半径 
public float getR() { 
return r; 


] 


然后 创建 一 个 矩形 类 MyRect: 


Public class MyRect { 
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// 矩形 图 形 的 图 片 
Private Bitmap bmp; 
// 矩形 图 形 的 坐标 
private float x, y; 
/** 

* 矩形 图 片 构造 函数 

* @param bmp 资源 图 片 


{ 
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* @param x 甜 形 图 形 X 坐标 
* @param y 甜 形 图 形 Y 坐标 
* eparam r 和 矩形 图 形 半径 
ef 
public MyRect (Bitmap bmp, float x, float y) { 
this.bmp = bmp; 
this.x = x 
this.y = y; 
; 
/** 
* 矩形 图 形 绘制 函数 
* @param canvas 画布 实例 
* @param paint 画笔 实例 
区 
Public void drawMyRect (Canvas canvas, Paint paint) { 
canvas .drawBitmap (bmp, x, y, paint); 


// 设置 矩形 图 形 的 X 坐标 
Public void setX (float x) { 
this.x = x; 


; 

// 设 置 和 矩形 图 形 的 Y 坐标 

public void setYy (float y) { 
this.y = y; 


有 
// 获 取 和 矩形 图 形 的 宽 
public int getW() { 
return bmp.getWwidth(); 


' 
// 获 取 和 矩形 图 形 的 高 
Public int getH() { 
return bmp .getHeight () ; 


按钮 与 两 个 Body 图 形 类 设计 完毕 ， 接 下 来 我 们 开始 分 析 整 体 游戏 框架 。 从 图 8-4 所 示 的 
游戏 流程 图 中 ， 可 以 看 出 整个 游戏 主要 可 分 为 以 下 3 个 状态 : 
ee 状态 一 : 主 菜 单 ; 
: 帮助 界面 ; 
: 正在 进行 游戏 。 
正在 进行 游戏 的 状态 又 分 为 以 下 3 种 情况 : 
e 暂停 游戏 ; 
e 游戏 胜利 ; 
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e 游戏 失败 。 
以 上 游戏 状态 可 以 在 主 类 MySurfaceView 中 定义 ， 代 码 如 下 : 


// 声明 游戏 状态 常量 

// 主 菜单 界面 

Private final int GAMESTATE MENU = 0; 

// 帮助 界面 

Private final int GAMESTATE HELP = 1; 
// 游 戏 界面 

Private final int GAMESTATE GAMEING = 2; 
// 当 前 游戏 状态 为 主 菜单 

Private int gameState = GAMESTATE MENU; 


定义 游戏 状态 之 后 ， 在 逻辑 、 绘 制 、 触 屏 与 实体 按键 等 函数 中 也 根据 戏 状态 来 处 理 : 


switch (gameState) { 
Case GAMESTATE MENU: 
break; 
Case GAMESTATE HELP: 
break; 
Case GAMESTATE GAMEING: 
break; 


这 样 一 来 游戏 整体 的 结构 就 很 清晰 了 ， 根 据 不 同 的 游戏 状态 写 出 对 应 的 处 理 代码 与 绘制 
方法 。 
回 到 主 视图 类 ， 在 MySurfaceView 中 ， 添 加 创建 圆 形 Body 与 矩形 Body 两 个 函数 (为 了 
便于 讲解 ， 图 片 按钮 等 资源 的 声明 与 实例 在 此 省 略 ) : 


// 在 物理 世界 中 添加 矩形 Body 
public Body createRect (Bitmap bmp, float x, float y, float w, float h, 
float density) { 
PolygonDef pd = new PolygonDef(); 
pd.density = density; 
pd.friction = 0.8f; 
pd.restitution = 0.3f; 
pd.setAsBox(w / 2 / RATE, h / 2 / RATE); 
BodyDef bd = new BodyDef(); 
bd.position.set((x +w/ 2) / RATE, (y + h / 2) / RATE); 
Body body = world.createBody (bd); 
body.m userData = new MyRect (bmp, x, y); 
body.createShape (pd); 
body.setMassFromShapes (); 
return body; 
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// 在 物理 世界 中 添加 圆 形 Body 
public Body createCircle(Bitmap bmp, float x, float y, float r, float 
density) { 
CircleDef cd = new CircleDef(); 
cd.density = density; 
cd.friction = 0.8f; 
cd.restitution = 0.3f; 
cd.radius = r / RATE; 
BodyDef bd = new BodyDef(); 
bd.position.set((x + r) / RATE, (y + r) / RATE); 
Body body = world.createBody (bd); 
body.m userData = new MyCircle(bmp, x, y, r); 
body. createShape (cd); 
body. setMassFromShapes () 7 
body.allowSleeping (false) ; 
return body; 


创建 Body 过 程 就 不 再 详 述 ， 主 要 提醒 一 点 : 


在 创建 圆 形 Body 时 ， 设 置 了 body.allowSleeping (false) 这 个 属性 ， 此 属性 设置 Body 永 
远 不 进入 睡眠 。 设 置 其 属性 的 作用 是 : 防止 主角 小 球 进入 睡眠 ， 导 致 改变 物理 世界 的 重力 方 


向 无 法 移动 已 休眠 的 Body。 


防止 小 球 进入 睡眠 的 方法 除了 此 种 方法 外 ， 也 可 以 在 每 次 改变 重力 方向 时 ， 使 用 


“bodyBall.wakeUp();” 语 句 来 唤醒 小 球 也 可 解决 。 


接 下 来 完成 添加 主 菜单 的 UI。 主 菜单 界面 比较 简单 ， 包 括 一 张 背 景 图 片 与 三 个 按钮 ， 添 


加 代码 如 下 : 
Public void myDraw() {// 绘 制 函数 


Switch (gameState) { 

case GAMESTATE MENU: 
// 绘 制 主 菜单 背景 
canvas .drawBitmap (bmp menubg, 0, 0, paint); 
// 绘 制 Play 按钮 
hbPlay.draw (canvas, paint); 
// 绘 制 Help 按钮 
hbHelp.draw (canvas, paint); 
// 绘 制 Exit 按钮 
hbExit.draw (canvas, paint); 
break; 

Case GAMESTATE HELP: 
break; 

Case GAMESTATE GAMEING: 
break; 

} 


375 


Android 游 戏 编程 之 从 零 开 始 


} 
Q@Override// 触 屏 按键 监听 


public boolean onTouchEvent (MotionEvent event) { 


switch (gameState) { 
Case GAMESTATE MENU: 
// 判 断 Play 按钮 是 否 被 点 击 
if (hbPlay.isPressed (event)) { 
//Play 按钮 被 点 击 开始 游戏 
gameState = GAMESTATE GAMEING; 
// 判 断 Help 按钮 是 否 被 点 击 
} else if (hbHelp.isPressed(event)) { 
//Play 按钮 被 点 击 进入 游戏 游戏 帮助 界面 
gameState = GAMESTATE HELP; 
// 判 断 Exit 按钮 是 否 被 点 击 
} else if (hbExit.isPressed (event)) { 
//Exit 按钮 被 点 击 调用 退出 函数 
MainActivity.main.exit (); 
} 
break; 
Case GAMESTATE HELP: 
break; 
Case GAMESTATE GAMEING: 
break; 


1 


return true; 


添加 帮助 界面 。 帮 助 界面 包括 一 张 背景 图 片 和 一 个 返回 按钮 ， 添 加 代码 如 下 : 
Public void myDraw() {// 绘 制 函数 


Switch (gameState) { 
Case GAMESTATE _ MENU: 
break; 
Case GAMESTATE HELP: 
// 绘 制 帮助 界面 背景 
canvas .drawBitmap (bmp helpbg, 0, 0, paint); 
// 绘 制 Back 按钮 
hbBack.draw (canvas, paint); 
break; 
Case GAMESTATE GAMEING: 
break; 
1 


376 


第 8 章 ”Box2D 物 理 游戏 实战 


} 
QOverride// 触 屏 按键 监听 


public boolean onTouchEvent (MotionEvent event) { 


switch (gameState) { 
Case GAMESTATE MENU: 


break; 


Case GAMESTATE HELP: 
// 判 断 Back 按钮 是 否 被 点 击 
if (hbBack.isPressed (event)) { 
//Back 按钮 被 点 击 进入 主 菜单 界面 
gameState = GAMESTATE MENU; 
break; 
Case GAMESTATE GAMEING: 
break; 
} 
return true; 


添加 游戏 界面 。 相 对 于 帮助 与 主 菜单 界面 而 言 ， 游 戏 UI 比较 复杂 ， 除 了 背景 与 主角 、 
障碍 物 等 绘制 ， 还 要 处 理 在 游戏 时 满足 胜利 与 失败 条 件 的 事件 ， 以 及 暂停 事件 。 

当 游戏 进行 时 ， 一 旦 满足 游戏 暂停 、 胜 利 、 失 败 条 件 ， 必 须 暂 停 游戏 逻辑 ， 让 物理 世界 
停止 模拟 ， 所 以 还 要 添加 逻辑 函数 的 处 理 代码 : 


public void myDraw() {// 绘 制 函 数 


switch (gameState) { 
case GAMESTATE MENU: 
break; 
Case GAMESTATE HELP: 
break; 
Case GAMESTATE GAMEING: 
// 绘 制 游戏 背景 
canvas .drawBitmap (bmp_ gamebg, 0, 0, paint); 
// 遍 历 物理 世界 中 所 有 存在 的 Body; 
Body body = world.getBodyList (); 
for (int i = 1; i < world.getBodyCount (); i++) { 
if ((body.m userData) instanceof MyRect) { 
MyRect rect = (MyRect) (body.m userData); 
rect.drawMyRect (canvas, paint); 
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} else if ((body.m userData) instanceof MyCircle) { 
MyCircle mcc = (MyCircle) 
(body.m userData); 
mcc.drawArc (canvas, paint); 
body = body.m next; 


} 
// 当 游戏 暂停 或 失败 或 成 功 时 
if (gameIsPause || gameIsLost || gameIsWin) { 
// 当 游戏 暂停 或 失败 或 成 功 时 画 一 个 半 透 明 黑 色 算 形 ， 突 出 界面 
Paint paintB = new Paint () 
paintB. setAlpha (0x77); 
canvas .drawRect (0, 0, screenW, screenH, paintB); 
’ 
// 游戏 暂停 
if (gameIsPause) { 
// 绘 制 暂停 背景 
canvas .drawBitmap (bmp_smallbg, screenW / 2 - 
bmp_smallbg.getWidth() / 2, screenH / 2 - bmp smallbg.getHeight() / 2, 
paint); 
/ /绘制 Resume 按钮 
hbResume .draw (canvas, paint); 
/ /绘制 Replay 按钮 
hbReplay .draw (canvas, paint); 
// 绘 制 Menu 按钮 
hbMenu.draw (canvas, paint); 
} else 
// 游 戏 失败 
if (gameIsSLost) { 
/ /绘制 游戏 背景 
canvas .drawBitmap (bmpLostbg, screenW / 2 - 
bmpLostbg.getwidth() / 2, screenH / 2 - bmpLostbg.getHeight() / 2, paint); 
/ /绘制 Replay 按钮 
hbReplay .draw (canvas, paint); 
/ /绘制 Menu 按钮 
hbMenu.draw (canvas, paint); 
} else 
// 游 戏 胜利 
if (gameIsWin) { 
/ /绘制 失败 背景 
canvas .drawBitmap (bmpWinbg, screenW / 2 - 
bmpWinbg.getWidth() / 2, screenH / 2 - bmpWinbg.getHeight () / 2, paint); 
/ /绘制 Replay 按钮 
hbReplay .draw (canvas, paint); 
/ /绘制 Menu 按钮 


hbMenu.draw (canvas, paint); 
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break; 


’» 
Q@Override// 触 屏 按键 监听 


public boolean onTouchEvent (MotionEvent event) { 


Switch (gameState) { 

Case GAMESTATE MENU: 
break; 

Case GAMESTATE HELP: 
break; 


Case GAMESTATE GAMEING: 
// 游戏 暂停 、 失 败 、 胜 利 
// (因为 游戏 失败 和 游戏 胜利 中 按钮 处 理事 件 一 样 ， 所 以 就 不 需要 重复 写 ) 
if (gameIsPause || gameIsLost || gameIsWin) { 
if (hbResume.isPressed (event)) { 
gameISPause = false; 
} else if (hbReplay.isPressed(event)) { 
// 因 为 在 重 置 前 小 球 可 能 拥有 力 ， 所 以 重 置 游戏 要 先 使 用 PutToSleep () 方 法 
// 让 其 Body 进入 睡 眼 ， 并 让 Body 停止 模拟 ， 速 度 置 为 0 
bodyBall .putToSleep(); 
// 然后 对 小 球 的 坐标 进行 重 置 
bodyBall .setXForm (new Vec2((bmpH.getHeight() + 
bmpBall.getWidth() / 2 + 2) / RATE, (bmpH.getHeight() + bmpBall.getWwidth() 
大 2 过) 人 RATEJ ‘0)s 
// 并 且 设置 默认 重力 方向 为 向 下 
world.setGravity (new Vec2(0, 10)); 
/ /唤醒 小 球 
bodyBall .wakeUp (); 
/ /游戏 暂停 、 胜 利 、 失 败 条 件 还 原 默认 false 
gameIsPause = false; 
gameIsSLost = false; 
gameIsWin = false; 
} else if (hbMenu.isPressed(event)) { 
bodyBall .putToSleep(); 
// 然后 对 小 球 的 坐标 进行 重 置 
bodyBall .setXForm (new Vec2 ( (bmpH.getHeight() + 
bmpBall.getWidth() / 2 + 2) / RATE, (bmpH.getHeight() + bmpBall.getWwidth() 
/2+2 / RATE), 0); 
// 并 且 设 置 默认 重力 方向 为 向 下 
world.setGravity (new Vec2(0, 10)); 
/ /唤醒 小 球 
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bodyBall .wakeUp (); 

// 重 置 游戏 状态 为 主 菜单 

gameState = GAMESTATE MENU; 

/ /游戏 暂停 、 胜 利 、 失 败 条 件 还 原 默 认 false 
gameIsPause = false; 

gameISLost = false; 

gameIsWin = false; 


break; 


return true; 
} 
/ /游戏 逻辑 函数 
Public void Logic() { 
switch (gameState) { 
Case GAMESTATE MENU: 
break; 
Case GAMESTATE HELP: 
break; 
Case GAMESTATE GAMEING: 
// 游戏 没有 满足 暂停 、 失 败 、 胜 利 条 件 时 
if (!gameIsPause && !gameIsSLost && !gameIsWin) { 
// -- 开 始 模拟 物理 世界 --->> 
world. step (timeStep, iterations); 
Body body = world.getBodyList (); 
for (int i = 1; i < world.getBodyCount(); i++) { 
if ((body.m userData) instanceof MyRect) { 
MyRect rect = (MyRect) (body.m userData); 
rect.setX (body.getPosition().x * RATE - 
rect.getW() / 2); 
rect .setY (body.getPosition().y * RATE - 
rect.getH() / 2); 
} else if ((body.m userData) instanceof MyCircle) 
{ 
MyCircle mcc = (MyCircle) (body.m userData); 
mcc.setX(body.getPosition() .x * RATE - 
mcc.getR()); 
mcc.setY(body.getPosition() .Y * RATE - 
mcc .getR () ) ; 
mcc.setAngle ( (float) (body.getAngle() * 180 / 
Math.PT) ) 
body = body.m next; 
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三 个 游戏 状态 绘制 与 按键 处 理 都 添加 完毕 之 后 ， 开 始 添加 主角 小 球 的 控制 移动 代码 : 


Q@Override 


public boolean onKeyDown (int keyCode, KeyEvent event) { 
// 当前 游戏 状态 不 处 于 正在 游戏 中 时 ， 屏 蔽 "返回 “实体 按键 , 避免 程序 进入 后 台 ; 
if (keyCode == KeyEvent .KEYCODE BACK && gameState != 


GAMESTATE GAMEING) { 


return true; 


} 


switch (gameState) { 
Case GAMESTATE MENU: 


break; 


Case GAMESTATE HELP: 


break; 


Case GAMESTATE GAMEING: 
// 游戏 没有 暂停 、 失 败 、 胜 利 
if (!gameIsPause && !gameISLost && !gameIsWin) { 
// 如 果 方 向 键 左 键 被 按 下 
if (keyCode == KeyEvent.KEYCODE DPAD LEFT) 


// 设 置物 理 世界 的 重力 方向 向 左 
world.setGravity (new Vec2(-10, 2)); 

/ /如果 方 向 键 右 键 被 按 下 

else if (keyCode == KeyEvent .KEYCODE DPAD RIGHT) 


// 设 置物 理 世界 的 重力 方向 向 右 
world.setGravity (new Vec2(10, 2)); 


/ /如果 方 向 键 上 键 被 按 下 


else 


if (keyCode == KeyEvent .KEYCODE DPAD UP) 
// 设 置物 理 世界 的 重力 方向 向 上 
world.setGravity (new Vec2(0, -10)); 


// 如 果 方 向 键 下 键 被 按 下 
else if (keyCode == KeyEvent .KEYCODE DPAD DOWN) 


// 设 置物 理 世 界 的 重力 方向 向 下 
world.setGravity (new Vec2(0, 10)); 


/ /如果 返 回 键 被 按 下 
else if (keyCode == KeyEvent .KEYCODE BACK) { 


// 进 入 游戏 暂停 界面 


gameIsPause = !gameIlsPause; } 


} 
// 屏 蔽 "返回 “实体 按键 , 避免 程序 进入 后 台 ; 
return true; 


1: 


return super.onKeyDown (keyCode, event); 
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在 方向 键 按 下 设置 物理 世界 重力 方向 的 时 候 ， 向 左 和 向 右 的 Y 轴 的 向 量 值 并 没有 设置 为 
零 ， 这 是 因为 Box2D 物理 世界 是 理想 化 的 ， 一 旦 设 为 零 ， 小 球 向 左 或 向 右 时 ， 就 会 有 种 很 
飘 、 很 假 的 感觉 ， 当 然 这 些 也 是 作者 的 个 人 感觉 ， 大 家 可 以 根据 实际 情况 进行 调整 。 

虽然 在 实体 按键 中 ， 对 “返回 ”按钮 进行 了 处 理 和 屏蔽 ， 但 是 还 要 考虑 Home 按键 的 处 
理 ， 虽 然 点 击 Home 不 会 像 点 击 Back 按键 一 样 重启 当前 Activity， 但 是 也 会 导致 执行 
SurfaceView 中 的 surfaceCreated 函数 ， 所 以 如 果 在 surfaceCreated 中 添加 了 一 些 初始 化 的 代 
码 ， 那 么 可 以 如 下 处 理 : 
//SurfaceView 创建 


Public void surfaceCreated (SurfaceHolder holder) { 
// 防 止 Home 按键 导致 游戏 重 置 
if (gameState == GAMESTATE MENU) { 


在 此 游戏 中 ， 游 戏 分 为 三 种 状态 。 那 么 ， 通 过 gameState 这 个 记录 当前 游戏 状态 的 变 
量 ， 可 以 有 效 防止 玩家 在 点 击 Home 按键 再 次 回 到 游戏 时 ， 又 重新 加 载 初始 化 surfaceCreated 
函数 中 的 代码 。 


另 .2 堆 房子 游戏 实战 


在 上 一 节 中 ， 详 细 介 绍 了 一 个 Box2D 小 游戏 ， 通 过 对 这 个 游戏 的 分 析 ， 一 方面 为 了 让 大 
家 加 深 对 游戏 制作 流程 的 理解 ， 另 一 方面 也 学 习 了 Body 的 创建 与 操作 方法 。 

本 节 将 再 继续 为 大 家 讲解 一 个 “ 堆 房 子 ” 的 游戏 ， 这 个 游戏 只 写 了 Demo， 没 有 完成 游 

@ 通过 关节 与 Body 相 结 合 制作 游戏 ; 

日 动态 创建 Body。 


至 于 游戏 未 完成 的 部 分 ， 大 家 可 以 自由 发 挥 将 其 完成 ， 这 里 就 不 再 说 明了 。 
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堆 房子 游戏 玩法 是 : 触摸 屏幕 使 悬挂 屏 
幕 上 方 的 方块 掉 落 。 游 戏 的 运行 效果 如 图 8- 
8 所 示 。 

首先 新 建 项 目 “BuildHouse”， 然 后 
将 Jbox2D 引擎 JAR 包 添 加 到 项 目 中 ， 如 
图 8-9 所 示 ， 项 目 对 应 的 源 代 码 为 “8-2 
( 堆 房 子 )”。 


图 8-8 堆 房子 游戏 截图 


人 而 NwAaodpdea ES 


New Android Project AL 
Creates a new Android project resource. TF 
Project name: BuildHouse 
Contents 
© Create new project in workspace 
Create project from existing source 
国 Use defauk location 
scation: | G/Book/workspace/aha Browse. 】 
© Create project from existing sample 
Samples: ApiDemos 
Build Target 
| Target Name Vendor Platform 。 API ... 
Android15 AndroidOpenSourceProject 15 3 
GoogleApls GoogleInc, 15 3 
国 Android16 Android Open source prajed 16 4 
] Google Apts 。 Google nc 16 4 
加 Android20 Android Open SourceProject 2.0 5 
GoogleApls GoogleInc. 20 5 
加 Android201 AndroidOpenSourceProject 201 6 
回 Google Aplis GoogleInc. 201 6 
@ Android 2.1-up.. Android Open Source Project = 21-up-。 7 
Standard Android platform 1.6 
Properties 
Application name: BuildHouse 
Package name: com.bh 
回 Create Activity: MainActivity 
Min SDK Version: 
@ Bock [Nea> |[ Einish |[ Cancel 


图 8-9 新 建 项 目 “BuildHouse” 
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模拟 器 的 配置 如 图 8-10 所 示 : 


| AVD details 


Name: android16 
Path: CAUsers\Himi\.android\avd\android16.avd 
Target: Android 1.6 (API level 4) 
Skin: HVGA 
SD Card: 20M 
hwsdCard: yes 


hwilcd.density: 160 
vm.heapSize: 24 


图 8-10 模拟 器 的 配置 
在 项 目 中 添加 资源 文件 如 图 8-11 所 示 : 


4 CG drawable-mdpi 


序列 图 片 说 明 图 片 名 称 图 片 


工 游戏 背 最 大 backgroundjpg 


2. 砖 块 1 国 tilel.png 
3 夸 块 2 园 tie2.png 
4. 砖 块 3 改 tile3.png 


8-11 在 项 目 中 添加 资源 文件 


首先 在 “MainActivity ”类 中 设置 游戏 全 屏 ， 并 且 显 示 自 定义 的 View 一 一 
“MySurfaceView” 类 。MySurfaceView 游戏 框架 中 有 基本 的 绘制 、 逻 辑 、 线 程 等 函数 。 这 两 
个 类 在 前 文 已 经 多 次 介绍 过 ， 大 家 再 熟悉 不 过 了 ， 这 里 不 再 详 述 。 
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从 图 8-8 所 示 的 项 目 效果 中 可 以 看 出 ， 游 戏 大 致 可 分 为 两 种 Body， 一 种 砖 块 Body， 一 
种 正常 矩形 Body。 那 我 们 就 先 添加 这 两 个 对 应 的 Body 图 形 类 MyRect 和 MyTile。 
MyRect 类 的 代码 如 下 : 


public class MyRect { 
// 和 矩形 图 形 的 位 置 、 宽 高 与 角度 
private float x, y, w, h, angle; 
// 和 矩形 图 形 的 初始 化 
Pub1lic MyRect (float x, float y, float w, float h) { 
this.x = x; 


this.y = y; 
this.w = w; 
this.h = h; 
} 
// 和 矩形 图 形 绘制 函数 


Public void drawRect (Canvas canvas, Paint paint) { 
canvas .save () ; 
canvas.rotate(langle, x +w/2,y+h/ 2); 
canvas.drawRect (x, y, x + WwW y + h, paint); 
canvas.restore(); 


} 

/7 设置 矩形 图 形 的 X 坐标 

public void setX (float x) { 
th 


) 

// 设 置 矩 形 图 形 的 Y 坐标 

Public void setY(float Y) { 
this.y = Y7 


// 设 置 矩 形 图 形 的 角度 
Public void setAngle (float angle) { 
this.angle = angle; 


! 

// 获 取 和 矩形 图 形 的 宽 

Public float getwidth() { 
return w; 


// 获 取 和 矩形 图 形 的 高 
public float getHeight() { 


return h; 
} 


MyTile 类 的 代码 如 下 : 


public class MyTile { 
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// 砖 块 的 坐标 、 宽 高 与 角度 

Private float x, y, w, h, angle; 

// 砖 块 的 图 片 资源 

Private Bitmap bmp; 

// 砖 块 初始 化 

Public MyTile (float x, float y, float w, float h, Bitmap bmp) 
this.x = x; 


this.y = y; 
this.w = w; 
this.h = h; 


this.bmp = bmp; 


} 

// 砖 块 的 绘制 

Public void drawMyTile (Canvas canvas, Paint paint) { 
Canvas.save(); 
canvas.rotate(angle, x +w/2,y+h/ 2); 
canvas .drawBitmap (bmp, x, y, paint); 
canvas.restore(); 


1 

// 获 取 砖 块 的 X 坐标 

public float getX() { 
return x; 


| 

// 获 取 砖 块 的 Y 坐标 

public float getY() { 
return y; 


1 

// 设 置 砖 块 的 x 坐标 

Public void setx(float x) { 
Chg 


' 

// 设 置 砖 块 的 坐标 

public void setY(float y) { 
this.y = y; 


: 

// 获 取 砖 块 的 宽 

Public float getNidth() { 
return w; 

} 

// 获 取 砖 块 的 高 

Public float getHeight() { 
return h; 


// 设 置 砖 块 角度 
Public void setAngle (float angle) { 
this.angle = angle; 
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两 个 类 结构 比较 简单 、 而 且 实现 方法 基本 相同 ， 主 要 的 区 别 在 于 MyTile 比 MyRect 类 中 


多 了 图 片 属性 。 接 下 来 下 面 实现 一 下 “MySurfaceView” 类 。 


首先 初始 化 图 片 资源 、 创 建物 理 世 界 ， 这 里 就 不 再 详 述 。 


(1) 创建 一 般 的 矩形 Body 函数 : 
/ /创建 算 形 Body 


在 代码 中 添加 3 个 重要 函数 : 


public Body createPolygon (float x, float y, float w, float h, float angle, 


float density) { 
PolygonDef pd = new PolygonDef(); 
pd.density = density; 
pd.friction = 0.8f; 
pd.restitution = 0.3f; 
pd.setAsBox(w / 2 / RATE, h / 2 / RATE); 
BodyDef bd = new BodyDef (); 
bd.position.set((x + w / 2) / RATE, 
bd.angle = 
Body body = world.createBody (bd); 
body.m userData = new MyRect (x, y, w, h); 
body.createShape (pd); 
body.setMassFromShapes (); 
return body; 


(2) 创建 砖 块 Body 函数 : 
/ /创建 装 块 Body 


(Y+h/ 2) / RATE); 
(float) (angle * Math.PI / 180); 


Public Body createMyTile (float x, float y, float w, float h, float angle, 


float density) { 
PolygonDef pd = new PolygonDef(); 
pd.density = density; 
pd.friction = 0.8f; 
pd.restitution = 0.3f; 
pd.setAsBox(w / 2 / RATE, h / 2 / RATE); 
pd.filter.groupIndex = 2; 
BodyDef bd = new BodyDef(); 
bd.position.set((x + w / 2) / RATE, 


bd.angle = (float) (angle * Math.PI / 180); 
Body body = world.createBody (bd) ; 
// 实 例 随机 库 


random = new Random(); 
// 取 出 0-2 的 随机 整数 
ran = random.nextInt (3); 


//bmp : 绑 定 在 距离 关节 上 的 动态 Body 


(Yt hy 2) / RATE) 5 
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//bmpTilel、bmpTile2、bmpTile3 分 别 是 三 种 砖 块 的 图 片 资源 
if (ran == 0) 
bmp = bmpTilel; 
else if (ran == 1) 
bmp = bmpTile2; 
else if (ran == 2) 
bmp = bmpTile3; 
body.m userData = new MyTile(x, y, w, h, bmp); 
body.createShape (pd); 
body.setMassFromShapes (); 
return body; 


创建 步 又 与 一 般 和 矩形 Body 创建 类 似 ， 只 是 赋值 m_userData 属性 时 ， 为 了 让 每 次 随机 创 
建 不 同 ， 所 以 通过 Rondom 获取 随机 数 ， 通 过 随机 数 来 对 应 不 同 的 图 片 资源 ， 从 而 创建 不 同 
图 片 的 Body。 

(3) 创建 距离 关节 函数 : 


/ /创建 距离 关节 
public DistanceJoint createDistanceJoint (Body bodyl, Body body2) { 
// 创 建 距离 关节 信息 
DistanceJointDef dj = new DistanceJointDef(); 
dj .bodyl = bodyl; 
dj .bodqy2 = body2; 
// 初 始 化 距离 关节 
dj.initialize (bodyl, body2, bodyl.getWorldCenter(), 
body2.getWorldCenter ()); 
// 通 过 World 创建 一 个 距离 关节 对 象 


return (DistanceJoint) world.createJoint (dj) 


这 些 预备 工作 做 好 之 后 ， 开 始 往 视图 中 添加 游戏 元 素 。 因 为 方块 Body 的 运动 轨迹 成 摇 
摆 状 ， 所 以 可 以 利用 距离 关节 来 实现 ， 只 要 固定 一 个 距离 关节 中 的 一 个 Body 为 静态 ， 另 外 
-个 Body 为 动态 即 可 。 添 加 游戏 元 素 的 步骤 如 下 : 


仍 志 于 了 添加 一 个 静态 Body， 放 置 在 屏幕 最 下 方 ， 用 于 放置 掉 落 的 Body 出 屏 。 
createPolygon(0，getHeight () ，getWidth() - 10, 10, 0, 0); 
他 亚 吏 添加 距离 关节 。 


/7 实例 游戏 初始 两 个 绑 定 距离 关节 的 Body 

//bodyWall : 固定 在 屏幕 顶端 的 静态 Body 

bodyWall = createPolygon (bodyWallX, bodyWallY, bodyWallW, bodyWallH, 
0, 0); 

//bodyHouse: 砖 块 Body 


388 


第 8 章 Box2D 物 理 游 戏 实战 


bodyHouse = createMyTile (bodyWallX / 2, bodyWallY + bodyWallH + 50, 
bmpTilel .getWidth(), bmpTilel.getHeight (), 0, 1); 

//dj :距离 关节 对 象 

// -添加 一 个 距离 关节 

dj = createDistanceJoint (bodyWall, bodyHouse); 


游戏 中 ， 方 块 bodyWall 为 距离 关节 中 的 静态 物体 ，bodyHouse 为 距离 关节 中 的 动态 物 
体 ， 所 以 我 们 将 bodyWall 的 质量 设 为 0。 


他 王 驶 启动 物理 世界 模拟 、Body 与 图 形 数据 传 值 以 及 绘制 。 


逻辑 函数 Logic 是 线程 不 断 调用 的 函数 ， 代 码 如 下 : 


// 逻 和 辑 处 理 函 数 
Private void logic() { 
// 物 理 世界 模拟 
world.step (stepTime， iteraTions) 
// 遍 历 Body， 进 行 Body 与 图 形 之 间 的 传递 数据 
Body body = world.getBodyList (); 
for (int i = 1; i < world.getBodyCount (); i++) { 
// 判 定 m_userData 中 的 数据 是 否 为 MyRect 实例 
if ((body.m userData) instanceof MyRect) { 
MyRect rect = (MyRect) (body.m userData); 
ect .setX(body.getPosition() .x * RATE 一 
rect.getwidth() / 2); 
ect .setY(body.getPosition () .Y * RATE - 
rect.getHeight() / 2); 
rect .setRAngle ( (float) (body.getAngle() * 
180 / Math.PI)); 
} else if ((body.m userData) instanceof MyTile) { 
// 判 定 m_userData 中 的 数据 是 否 为 MyTile 实例 
MyTile tile = (MyTile) (body.m userData); 
tile.setX(body.getPosition() .x * RATE — 
tile.getWidth() / 2); 
tile.setY (body.getPosition().y * RATE 一 
tile.getHeight () / 2); 
tile.setAngle((float) (body.getAngle() * 
180 / Math.PI)); 
} 
body = body.m next; 


绘制 函数 MyDraw 也 是 需要 线程 不 断 调用 的 函数 ， 代 码 如 下 : 
/7 绘制 函数 
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public void draw() { 


// 获 取 画 布 实例 

canvas = sfh.lockCanvas (); 

// 刷 屏 

canvas .drawColor (Color. BLACK); 

// 绘 制 游戏 背景 图 

canvas.drawBitmap (bmpBg, 0, -Math.abs(getHeight() -— 
bmpBg.getHeight ()), paint); 

// 遍 历 绘制 Body 

Body body = world.getBodyList (); 

for (int i = 1; i < world.getBodyCount (); i++) { 

if ((body.m userData) instanceof MyRect) { 
MyRect rect = (MyRect) (body.m userData); 
rect .drawRect (canvas, paint); 

} else if ((body.m userData) instanceof MyTile) { 
MyTile tile = (MyTile) (body.m userData); 
tile.drawMyTile (canvas, paint); 

} 

body = body.m next; 

b 
if (bodyWall != null && bodyHouse != null) { 
if (dj != null) { 


/ /设置 画笔 颜色 

//1lineColor:int 数组 ， 保 存 三 种 颜色 值 ; 
// 分 别 表示 不 同方 砖 的 悬挂 强 颜色 
paint.setColor (lineColor [ran] ); 

/ /设置 画 笔 的 粗细 程度 
paint.setStrokeWidth (3); 

/ /绘制 悬挂 绳 


canvas .drawLine (bodyWall .getPosition() .x * RATE, 
bodyWall .getPosition().y * RATE，bodyTemp .getPosition () .x * RATE, 
bodyTemp .getPosition().y * RATE, paint); 
1 
} 


绘制 距离 关节 ， 其 实 就 是 连接 距离 关节 中 的 两 个 Body 所 在 物理 世界 的 中 心 点 。 


接 下 来 处 理 触 屏 事件 。 


游戏 中 触 屏 ， 让 摇摆 的 方块 下 落 ， 做 法 一 般 有 两 种 : 


ee 触 屏 时 ， 摊 毁 距 离 关节 ， 绑 定 在 距离 关节 中 的 自由 落体 ， 下 次 创建 新 的 Body 绑 定 新 
的 距离 关节 中 ; 
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。 触 屏 时 ， 创 建 一 个 新 的 Body， 其 位 置 等 属性 应 与 绑 定 在 距离 关节 上 动态 Body 一 致 ， 
让 其 自由 落体 。 


这 里 我 们 使 用 第 一 种 方式 ， 首 先 创建 两 个 布尔 值 和 一 个 临时 Body， 然 后 再 实现 触 屏 事 件 
和 逻辑 处 理 函 数 : 


Private Body bodyTemp;// 永 远 指向 距离 关节 的 动态 Body 实例 
Private boolean isDown;// 表示 是 否 动态 Body 是 否 开始 下 落 
Private boolean isDeleteJoint;// 是 否 删除 距离 关节 

// 触 屏 事件 


QOverride 


public boolean onTouchEvent (MotionEvent event) { 


if (isDown == false) { 


if (event.getAction() == MotionEvent.ACTION DOWN) { 
/1 删除 关节 
isDeleteJoint = true; 
/1 动态 Body 下 落 


isDown = true; 
’ 


return true; 


关节 的 删除 操作 并 没有 在 触 屏 中 直接 处 理 ， 其 原因 之 前 也 详细 说 过 ， 放 置物 理 世 界 模拟 


时 ， 出 现 野 指针 ， 导 致 报错。 所 以 触 屏 中 我 们 用 isDeleteJoint 布尔 值 来 标识 该 删除 关节 ， 而 
删除 操作 放 在 世界 模拟 之 后 处 理 。 


// 逻 辑 处 理 函 数 
Private void logic() { 


// 动 态 Body 是 否 下 落 
if (isDown == true) { 
// 计 时 器 计时 
isDownCount++; 
// 计 时 器 时 间 
if (isDownCount % 120 == 0) { 
/ /创建 新 的 动态 Body- 砖 块 ， 并 且 使 用 临时 Body 保存 最 新 动态 Body 
bodyTemp = createMyTile(bodyWallX / 2, bodyWallY + 
bodyWallH + 50, bmpTilel .getWidth(), bmpTilel.getHeight(), 0, 1); 
// 创 建新 的 距离 关节 
dj = createDistanceJoint (bodyWall, bodyTemp); 
// 计 时 器 重 置 
isDownCount = 0; 


/ /下落 标 识 重 置 


391 


Android 游 戏 编程 之 从 雯 开始 


isDown = false; 


整个 游戏 流程 很 简单 ， 实 现 起 来 也 不 难 。 这 里 ， 还 是 要 再 次 提醒 大 家 ，Body 物体 与 
Joint 关节 的 删除 操作 一 定 要 放置 在 物理 世界 模拟 后 操作 ， 这 是 使 用 Box2d 开发 游戏 最 值得 注 
意 的 地 方 。 


日 .了 本 章 小 结 


本 章 详细 剖析 了 迷宫 小 球 和 堆 房子 游戏 的 实现 方法 。 从 迷宫 小 球 游戏 实战 中 ， 读 者 可 以 
加 深 对 游戏 制作 流程 的 理解 ， 同 时 巩固 了 Body 创建 与 操作 的 方法 。 从 堆 房 子 游戏 实践 中 ， 
读者 可 以 掌握 通过 关节 与 Body 相 结 合 制作 游戏 的 方法 。 
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